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CAL3,4 


(Fetch subsystem) 
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59 


CAL3, 8 


(Return TCB address) 


60 


CAL3, 9 
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1. INTRODUCTION 



The SDS Sigma 5/7 Batch Time-Sharing Monitor (BTM) is an 
extension of the Sigma 5/7 Batch Processing Monitor (BPM) . 
The BTM time-sharing system offers efficient, comprehen- 
sive, and compatible batch processing service concurrently 
with conversational time-sharing. 



On-line services are provided by the following subsystems: 

BASIC processor 

EDIT source file editor 

FERRET file utility subsystem 

FORTRAN IV-H compiler 

SYMBOL assembler 

LOADER object module loader 

BPM batch job controller 

DELTA debug package 
Batch processing services are accessed by: 

Local batch submitted at the central computer 

Remote batch through high-speed terminals 

Terminal batch for on-line users 



BTM users may choose between any of the available system 
services with ease and flexibility, in either the on-line or 
batch mode, because: 

• Batch mode equivalents are provided for the on-line 
FORTRAN IV-H, BASIC, and SYMBOL processors 

• A common file-management system provides compati- 
ble file structures 

• Comprehensive and compatible accounting information 
is provided for both modes of operation 

Installation management may control job processing by: 

• Specifying which remote terminals may have access to 
the batch processing background 

• Permitting system access only to those users whose 
name and account number are recognized 



See the SDS Sigma 5/7 Batch Processing Monitor Reference 
Manual, publication number 90 09 54. 



• Broadcasting messages to all terminal users from the 
central computer 

• Shutting down user terminals, from the central com- 
puter, to recover the on-line core memory space for 
batch processing 

• Specifying the highest batch job priority allowed for 
each individual terminal user 

• Altering the priorities of jobs in the batch stream 

Typical hardware configuration requirements for use of BTM 
are as follows: 

• CPU (Sigma 5 or 7) with memory protection, floating- 
point arithmetic, and two each of the following: reg- 
ister blocks, external interrupt levels, and real-time 
clocks 

• 48K core memory 

• Card reader 

• Typewriter 

• 6MB RAD storage (system and file storage) 

• High-speed RAD and Selector IOP (swap storage for 
24-user system) 

• Two magnetic tape units 

• Line printer 

• Character-oriented-communication controller (line 
interface units, send/receive modules, and format tim- 
ing group as required) 

• Teletype unit for each on-line user 

Recommended in addition to the above are: 

• Card punch 

• Decimal arithmetic option 

• 16K core memory 

USER TERMINAL FUNCTIONS 

The user terminal consists of an ASR Teletype (with paper 
tape capability) or KSR Teletype (keyboard only). The 
Teletype provides the communication link between the user 
and the computer. Input is typed in by the user and out- 
put is printed by the BTM system. Figure 1 shows the 
Teletype keyboard and Figure 2 the control panel. 
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m These keys art missing on some models. [T] This key is posiHoned elsewhere on some model; 



Figure 1. Teletype Keyboard Configuration 



In this diagram, characters obtained by depressing the SHIFT key are shown at the top of the key and characters obtained by depressing the 
CTRL key are shown at the bottom of the key. Characters obtained by depressing both SHIFT and CTRL keys are shown above the character 
key. On the actual keyboard, all unparenthesized forms appear at the top of the key. 
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Figure 2. User Terminal Control Panel 



Appendix A describes the functions of the operating con- 
trols and special keys. 

ON-LINE OPERATIONS 

Time-sharing, or more precisely resource sharing, in the 
BTM system is achieved by alternately processing part of a 
batch job and part of an on-line job. Batch and on-line 
processing modes are each allocated a specified time slice 
or "quantum". When the current batch quantum expires, 
the next active on-line user's job is processed. The core/ 
disc swapping of on-line jobs is typically performed during 
the batch time quantum. The area of core memory dedi- 
cated to batch processing is not swapped to disc storage. 



I/O FILES 

I/O files for on-line users are maintained on the RAD. The 
terminal user may request that these files be copied to card 
punches, line printers, and magnetic tapes at the central 
computer or to his terminal. Files input from punched cards 
or magnetic or paper tape may be saved on the RAD for 
later access by the terminal user. Complete file security is 
provided by the comprehensive file management system. 



OFF-LINE 1 " OPERATIONS 

Batch jobs may be entered from a user terminal through use 
of the BPM subsystem (see Chapter 6), thus affording the 
terminal user full capabilities of batch processing. 

All of the BPM processors (e.g., COBOL, SORT, MERGE, 
SDS FORTRAN IV, 1401 Simulator, Meta-Symbol, etc.) 
are available to the on-line user in the batch mode. 

Batch jobs submitted in this manner are then merged into 
the background job stream on the RAD and are queued for 
execution (during the batch quantum) according to their 
relative priorities. 

The on-line user may, at any time, query the system to 
determine the current status (i.e., waiting, running, or 
completed) of any specified batch job. 



"Off-line" usually refers to operations performed by per- 
ipheral devices not controlled by a CPU. For conven- 
ience in this manual, however, "off-line" is used exten- 
sively to identify all operations not performed by the on-line 
BTM system. 
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2. START-UP PROCEDURE 



On-line service is obtained from BTM by activating the 
user terminal and logging into the system as outlined below. 

ACTIVATION PROCEDURE 

The user terminal is activated by depressing the "ORIG" 
key (see Figure 2, Teletype Control Panel). The key 
latches in the depressed position and is illuminated; it re- 
mains in this condition until the user deactivates the termi- 
nal (see "BYE Command", Chapter 3). 



LOG-IN PROCEDURE 

After the terminal is operational, the user alerts the BTM 
system by momentarily depressing the BREAK key or © © 
(see Figure 1, Teletype Keyboard). When the system is 
operative, the following messages will be printed:' 

BTM SYSTEM IS UP 
date and time 
ILOGIN: 



The exclamation character in the last line of the above 
message informs the user that he is communicating with the 
BTM Executive; the colon signifies a request for data. In 
this instance, the data required from the user is as follows: 

ILOGIN: n ame,acctr,pass"| ® 



name is any 1 - 12-byte name, 

acct is any 1 - 8-byte account ID. 

pass is any 1 - 8-byte password. 

© is the Carriage Return key. 



Embedded blanks are possible in any of the specifications. 
Only one password is legal for each unique name-account 
pair. The same password can be associated with several 
users and several names may be used with the same account. 
The password may be made up of nonprinting control 
characters" if the user so desires. 



Messages output by BTM are underlined throughout this 
manual, although in an actual session such Teletype output 
is not underlined. 

A control character is produced by holding down the CTRL 
key and then depressing a key for any character on the user 
console. 



After the user responds to the log-in request, his name, ac- 
count, and password combination is checked for validity. 
If valid, that is, if the name-account-password combination 
is in the accounting file, he is logged in and Executive ser- 
vices are at his disposal. If invalid, a new log-in request 
is issued. If no accounting file is in existence, anyone may 
log-in under an arbitrary name-account pair. 

After LOGIN, the system prints on the user's console: 

ID = <* 

where a is A, B, . . . ,Z, 1, ... ,6 depending on the COC line 
number of the user's terminal which may range from 0-31. 
Higher line numbers recycle through the characters A through 
6. For instance, a terminal connected to line number 3 re- 
ceives the message: 

ID = D 

In any of the subsystems that provide built-in output or 
scratch files, this ID letter is made part of the name in or- 
der to provide unique file names for simultaneous users under 
the same account. 

These subsystems and file names are: 

Subsystem File Name File Function 

BASIC RUNaflL scratch file 

SYMBOL BOTEMPff default binary out 

FORTRAN BOTEMPa default binary out 

SOTEMPff default source out 

LOAD BOTEMPo default binary input 

SDaf IL scratch file for de- 

bugging symbol tables 

When the user logs out (BYE), his running statistics are up- 
dated and his statistics for the current session are displayed, 
along with the amount of disc space still available to him. 
The accumulated totals are available only to the installation 
supervisor (see Chapter 12, "Supervisory Subsystem"). 

Following the log-in procedure, BTM outputs an exclama- 
tion character, indicating that the Executive is ready to 
accept commands. 

If BTM prints an exclamation character as soon as the BREAK 
key is depressed, this indicates that a previous user of the 
terminal has failed to log out. In such a case, the user 
should key in a BYE command before logging in. 

The following example shows the proper log-in procedure. 

BTM SYSTEM IS UP 

10/15/69 09.42 

[LOGIN: SMITH, SDS 123, PASSOK © 



Start-up Procedure 



3. BTM EXECUTIVE 



The BTM ExecuHve responds to control commands that direct 
the flow of the user's on-line work. There are 14 such 
commands: 



1. 


ASSIGN 


8. 


LOAD 


2. 


TABS 


9. 


SYMBOL 


3. 


BASIC 


10. 


SUPER 


4. 


BPM (Terminal Batch Entry) 


11. 


SAVE 


5. 


EDIT 


12. 


RESTORE 


6. 


FERRET 


13. 


PROCEED 


7. 


FORTRAN 


14. 


BYE 



ASSIGN allows the user to specify RAD I/O file assignments. 
TABS enables tab stops to be set for the Teletype at the user 
terminal. BASIC, BPM, EDIT, FERRET, FORTRAN, LOAD, 
SUPER and SYMBOL are subsystem calls. SAVE and RE- 
STORE allow the user to interrupt his on-line work and re- 
sume the session at a later time. PROCEED permits an in- 
terrupted subsystem to continue operation. BYE is used to 
terminate an on-line session. 

Executive commands may be given only when the Executive 
is in control, as indicated by the printing of an exclamation 
character on the Teletype. The user types in the first two 
letters of the mnemonic and the Executive prints the re- 
maining letters. If the Executive does not recognize a 
command, it informs the user by printing a question mark. 
It then begins a new command line with an exclamation 
character, so that the user may repeat the command. 

After the Executive has completed the command mnemonic, 
the user supplies any necessary parameters and terminates 
the command by giving a carriage return. Commands that 
never include parameters following the mnemonic (e.g., 
all subsystem calls) are terminated automatically by the 
Executive: the user should not supply the ®. At any time 
prior to the termination of a command, the user may cancel 
the command by depressing the BREAK key momentarily. 
The Executive ignores a canceled command and begins a 
new command line. 

Discussions of the use of Executive commands and the BREAK 
key are given below. 

RAD FILE ASSIGNMENT 

ASSIGN COMMAND 

The ASSIGN command controls all RAD file assignments for 
BTM users, with the exception of assignments made automat- 
ically by subsystems. The format of this command is similar 
to that of the ASSIGN command of the BPM. The general 
form of the command is shown below. Items shown in capital 
letters are required; those in lower case represent parameters. 
Optional items are denoted by brackets, although no brack- 
ets are actually used in ASSIGN commands. 



! ASSIGN deb name [, (FILE, file name)] [,(option). . .] 

where 

deb name is a DCB name of up to eight alphanu- 

meric characters. The first two characters must 
be either F: or M: (F: denotes user DCBs and M: 
denotes system DCBs). 

file name is a user-selected identifier of up to 

eight letters and/or digits. 

Files can be saved for future use through the PERM option 
(see beiow). The various ASSIGN options recognized by the 
BTM Executive are listed below. Each option may be en- 
closed in parentheses, and options must be separated by 
commas. No blanks are allowed within the specification 
field. If only the DCB name is specified, default values 
are assumed for all option parameters and the default assign- 
ment (if any) for the DCB is assumed also. 



Option 


Meaning 


Comment 


IN 


Input file 


Existing file to be read only. 


OUT 


Output file 


New file to be written only. 


INOUT 


Update file 


Existing file to be read and 
written. 


OUTIN 


Scratch file 


New file to be written and 
read. 


PERM 


Permanent 


Default for input fiies. 


TEMP 


Temporary 


Default for output files. 


HERE 


Teletype 


Assign the DCB to the user 
Teletype. 


REL 


Release ~\ 


SAVE 


Don't release 




PASS 


Password 


Same meaning as in BPM 
ASSIGN command. 


READ 


Read accts. 




WRITE 


Write accts. J 



Sample ASSIGN commands are shown below: 

'AS SIGN M :SI,(FILE,SIMBOLIK),(IN),(TEMP) 

The above command specifies that the RAD file named 
"SIMBOLIK" is to be used as a source input file. It may 
only be read, and is not to be saved when the user logs out. 

1AS SIGN M :DO,(HERE) 

This command specifies that the user terminal is to be used 
for diagnostic output. 

!AS SIGNM :BO 

This command specifies that the M:BO DCB is to be returned 
to its default assignment. 



BTM Executive 



TAB SETTING 

TABS COMMAND 

The TABS command sets up a tab sequence for the input from 
the user's Teletype. The form of the command is shown below. 



!TABS 



.[>,h]-h]] 



t. specify the tab positions desired. A blank speci- 

fication will cause all existing tabs to be deleted. 

A TABS command has the effect of clearing any previous tab 
settings. Thus, a maximum of eight tabs may be used in any 
one line of input. While keying in a line, a previously set 
tab is employed by depressing the ESCAPE key followed by 
the letter I. At this point, the input image is spaced to the 
next tab position, if any. If no tab exists beyond the present 
column, a "?" is echoed and the input image is spaced by 
one column. 

SUBSYSTEM CALLS 

FILE ASSIGNMENT 

With the exception of calls to the FORTRAN, LOADER, 
BPM, and SYMBOL subsystems, all file assignments are made 
after the subsystem is called. The user terminal is the de- 
fault assignment for DO, but it may be reassigned. In the 
case of FORTRAN and SYMBOL, the user may assign SI, LO, 
and BO to suit his own requirements. In the case of BPM, 
SI may be assigned to meet user requirements. The user ter- 
minal is the default assignment for SI and LO, and BO is 
assigned to the file "BOTEMPo'" unless reassigned by the 
user. BOTEMPo is also the default assignment for BI, the 
default input to the LOADER subsystem. 



CALLS 

Subsystem calls may be made whenever the BTM Executive 
is in control, assuming that proper file assignments have 
been made. The forms of the seven subsystem calls are 
shown below. 

! BASIC 



1BPM 

[EDIJ_ 

IFERRET 



{FORTRAN 



ILOAD 
1 SYMBOL 



ISUPER 



Once a subsystem call has been made, control is transferred 
to the called subsystem and the Executive remains inactive 
until control is returned to it by the subsystem or by the user 
(see "ESCAPE and PROCEED", below). 



SAVE AND RESTORE 

The SAVE and RESTORE functions are Executive services 
tnar permit the user to interrupt his on-line task and resume 
it at a later time. 



SAVE COMMAND 

The SAVE function causes the user's context block (i. e. , ma- 
chine environment), subsystem area, and user area to be writ- 
ten to a disc file under a user-specified filename. TheSAVEd 
file can then be retrieved from the RAD at a later time dur- 
ing the same session or during a future on-line session. 

The user may want to retrieve the SAVEd file from the RAD 
prior to logging out, but may not wish to SAVE it permanent- 
ly, in which case he may choose to declare the file tem- 
porary (i. e. , to be released at log-out time). This may be 
done by means of the TEMP option (see below). 

Prior to saving the environment, BTM automatically closes 
all active files. The user is responsible for any required 
file positioning, etc. Hence, it usually is not possible to 
successfully resume a compilation, assembly, or load. 

As with any Executive command, a SAVE command may be 
given only when the BTM Executive is in control of the 
system. The @ key (see below) can be used to return con- 
trol to the Executive. 

The SAVE command has the form shown below. 



ISAVE file name 



LTEMP 
[,PERM 



file name specifies a user-selected name of up to 

eight letters and/or digits. 

TEMP specifies that the SAVEd file is to be re- 
leased when the user logs out. If TEMP is speci- 
fied, the file cannot be RESTOREd (see below) 
after logging out, but may be RESTOREd at any 
time prior to logging out. 

PERM specifies that an existing TEMPorary file is 
to be changed to PERManent. 

RESTORE COMMAND 

The RESTORE function reloads and restarts the activity rep- 
resented in a file previously created in response to a SAVE 
command. If the specified file does not exist, was not 
SAVEd, or cannot be accessed for any other reason, a 
question mark will be printed. If the TEMP option (see 
below) is specified in the RESTORE command, the file will 
be released at the next log-out time. 

The form of the RESTORE command is shown below. 

{RESTORE file name[,TEMP] 
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file name specifies the name previously assigned 
to a SAVEd file. 

TEMP specifies that the file is to be released at 
log-out time. 

The user is returned to the Executive level. The PROCEED 
command may be used to restart a process interrupted by 
© © (see below). 

ESCAPE AND PROCEED 

The ESCAPE and PROCEED functions are Executive services 
that permit the user to interrupt a subsystem or user's pro- 
gram and- return to it from the Executive level. 

© KEY 

The ©key returns control to the BTM Executive. If a sub- 
system is in control, a single ESCAPE is sufficient; if the 
user's program is being executed, two successive ESCAPEs 
are required. 

Once the Executive has gained control, any Executive 
command can be given. However, if the user wishes to 
return to the interrupted activity without restarting it, he 
must not give any subsystem calls before returning control 
to the interrupted subsystem or program by means of a 
PROCEED command (see below). 



PROCEED COMMAND 

The PROCEED command continues a subsystem or program 
that has been interrupted by a previous ESCAPE (see above). 

The PROCEED command has the form shown below. 
! PROCEED 



LOG-OUT PROCEDURE 

An on-line work session is terminated by giving the Execu- 
tive command BYE. 



BYE COMMAND 

The BYE command informs the Executive that the user is 
logging out of the system. The Executive responds by 
printing the time and date on the line following the com- 
mand. It then prints a summary of statistics for the current 
session (see below). 

The BYE command has the form shown below. 



£BYE_ 

time-date 

RAD SPACE xx 

CPU xx. xxx 

I/O xx. xxx 

OVERHEAD xx.xxx 



(Granules of disc space used) 
(Minutes of CPU time used) 
(Minutes of I/O time used) 
(Minutes of CPU overhead time 
used) 



Each ESCAPE requires the ©key to be depressed twice, 
which reduces the likelihood of accidental ESCAPEs. 



The user terminal is disconnected from the computer auto- 
matically, following a BYE command. 



ESCAPE and PROCEED/Log-out Procedure 



4. TELETYPE OPERATIONS 



All Teletypes used in conjunction with the BTM system are 
required to operate in the full -duplex mode. In this mode, 
the input keyboard and the output printing mechanism are 
completely decoupled, so that depressing a key on the key- 
board does not, in itself, cause the corresponding graphic 
to be printed. Printing can be achieved only by direct com- 
mand of the attached computer. In the normal mode, the 
interrupt routine which processes the input character will 
immediately transmit back to the Teletype printing mechan- 
ism each such input character, thus causing it to be "echoed". 
Should there be any delay in retransmitting the character, 
the echo may fall behind the input —a disconcerting situa- 
tion, at first. Moreover, since the input and output opera- 
tions are entirely distinct, one may even type input while 
a subsystem Is printing output. 

Under BTM, a subsystem is "activated" whenever a suffi- 
cient amount of Teletype input has been accumulated for 
it to process, and it is "dismissed" if it requires further in- 
put when none is available. Because there is a substantial 
amount of overhead involved in activating one subsystem 
(and thereby dismissing another subsystem), it is desirable 
to allow as much Teletype input as possible to accumulate 
before activating the subsystem to process it. As the re- 
quirements for activation differ among subsystems, BTM 
provides each subsystem with the capability to specify what 
conditions constitute sufficient Teletype input. There are 
four such sufficient conditions (comprising the "activation 
classes"), as follows: 

1 . Input of a line feed, © or carriage return, © only. 

2. Input of one of the characters /, =, ©I, f , ©, 
or©. 

3. Input of a punctuation character (see Appendix A), or 
of ©or ®. 

4. Input of any character whatever. 

Clearly, condition 4 is the most severe, in that it requires 
the subsystem to be activated after each character is typed; 
whereas condition I is the most desirable, in that it requires 
activation only after each complete line of input. 

The primary effect of this on the user results from the fact 
that BTM will stop echoing input immediately after an acti- 
vation character is typed in and will not resume echoing 
until the subsystem has been activated and has read from 
BTM all the accumulated input, through the first character 
of the current message string. (This procedure is necessary 
to keep input and output correctly sequenced, since the 
subsystem may type out after each activation character.) 
Thus, echoing always stops until the subsystem has completely 
read the last activation image from BTM. Because some sub- 
systems may change activation classes as they run, it is 
sometimes difficult to know at a given point what the cur- 
rent activation class is. Basically, when the Teletype stops 
echoing input, an activation character has been typed and 
the subsystem has not yet been called. 



SPECIAL EDITING FEATURES 

BTM provides the Teletype user with several in-line editing 
capabilities, including the ability to backspace over char- 
acters and to erase lines. However, editing may only be 
performed on those characters typed in since the last acti- 
vation character was typed. That is to say, one cannot 
edit input across the boundaries defined by activation char- 
acters. When using the editing features described herein, 
the user must be aware of the activation class of the sub- 
system being executed to make correct use of these features, 
although trying to edit across an activation character bound- 
ary will never cause any unintended change to the input, 
but will rather cause part or all of the effect of the edit to 
be lost. 

Because the Teletype is a low-speed device, all Teletype 
I/O must be buffered, raising the possibility of I/O buffer 
overflow. Whenever the input buffer gets within ten char- 
acters of being full, each further input character will cause 
the Teletype bell to be rung immediately, to signal the im- 
pending buffer overflow. When the bell rings in this manner, 
the user should wait a few seconds before typing further. 
When the bell rings to signal impending buffer overflow, a 
control S (XOFF) is generated to turn off the paper tape 
reader (if in use). Later, when BTM requires input, a con- 
trol Q (XON) is generated to turn the paper tape reader 
back on. When the active subsystem has processed some of 
the data from the input buffer, the bell will no longer ring 
when input is entered. If, despite this warning, the input 
buffer becomes completely filled, each overflow character 
will be entered into the buffer as a ©(which always causes 
activation) and will be echoed as a question mark. The 
actual input character is lost, and the ©replaces the last 
character in the buffer. 

Should the output buffer approach overflow while a subsys- 
tem is doing Teletype output, that subsystem will be dis- 
missed for a while to allow the buffer to empty. Because 
the input echo is placed in the output buffer the same as any 
other output, it is possible for the user, by typing ahead of 
the echo, to overflow the output buffer with echo characters. 
In such a case, some echo characters will be lost. The 
actual input is not lost and will be correctly passed to the 
subsystem. Due to the way BTM sequences teletype I/O, 
such a loss of echoing can occur whenever the sum of the 
number of characters output by a subsystem and the number 
of characters the user has typed ahead of the echo exceeds 
the output buffer size (normally, one hundred characters). 



ACKNOWLEDGE (© Q) 



This code does not perform an editing function but is rather 
a device for letting the user know if BTM is still operating. 
This is especially useful when the Teletype becomes inactive 
for a long period and it is not clear whether the system has 
gone down or whether the subsystem is slow in respond- 
ing. Typing this character will thus result in a double 
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exclamation point (! !) being printed immediately (not in 
echo sequence) if BTM is still operating. 

BACKSPACE (©©) 

This code causes the last deletable character typed in to 
be "erased". Generally, this will be the character immed- 
iately preceding the backspace code, but in cases in which 
the preceding character is one which cannot be backspaced 
over, the backspace will erase the last character which can 
be backspaced over. Multiple backspaces are cumulative 
in that two successive backspace codes will erase the last 
two deletable characters, etc. Backspacing can be per- 
formed only back to (but not including) the last activation 
character. Any attempt to backspace over or beyond the 
activation character is ignored. A — is echoed to signal 
that the backspace has been performed. 



The input line is numbered from 1 to n for the purpose of 
tabbing. Position 1 is always the position of the first char- 
acter after the last activation character. Thus, all tab 
stops are measured relative to the last activation character, 
not the beginning of the physical line; tabbing is therefore 
primarily of value when the activation class is ©or ©. In 
addition, the line is numbered according to the edited input 
image, not the image as echoed on the Teletype. Giving 
a tab, even after assorted backspaces, erases, or other such 
editing functions, will always result in the correct number 
of spaces being echoed and transferred to the subsystem. 

For the purposes of backspacing, typing an ©I code is the 
same as typing the n spaces that the tab generates. Thus, 
each backspace after a tab will erase one of the n spaces 
of the tab, not the entire tab. To erase all n spaces, n 
backspace characters must be typed. 



ERASE (©X) 

Typing this character causes all input from the © X code 
back to (but not including) the last activation character to 
be erased. It is not possible to erase the activation char- 
acter or beyond, and any attempt to do so will be ignored. 
A © and © echoed to signal that the erase has been 
performed. 



STANDARD INPUT MODES 

To allow the user to relate the information on Teletype oper- 
ation to actual subsystem usage, the activation classes for 
most standard console operations are summarized below. 
Note that the majority of I/O is done under the activation 
class: "activate on ©or©". This is desirable because the 
special editing features are easiest to use in this mode. 



LOCAL NEW LINE (©©) 

Typing this code causes a ©and ©to be echoed, but no 
character is passed to the user subsystem. This permits the 
Teletype to be positioned physically to a new line without 
logically terminating the current input line. 

RETYPE (©R) 

Typing this code causes all input from the last activation 
character through the ©R to be retyped with all editing 
correctly performed (namely, backspacing, tabbing, and 
erasing.) Thus, the retyped image will be exactly identical 
to the image that the subsystem sees. This retyped image 
starts on a new line. 



At the Executive level: 

1. Immediately after typing the Executive "prompt" char- 
acter (I), the activation class is: "activate on every 
character". In this mode, no editing whatever is possi- 
ble and any editing character typed will be passed to 
the Teletype command processor unchanged. Thus, in 
the sequence 

! C ©@ B, 

not only is the effect of the backspace lost, but BTM 
will receive the four characters, 'C ©© B 1 , rather 
than the two it expects. 



TAB(© I) 

This code is used in conjunction with the TABS command. 
With the TABS command, the user may set or reset up to 
8 tab stops on his Teletype. When tab stops are set, the 
user may type in the tab code at any point, to skip over to 
the next tab stop. When entered, the tab code will echo 
the appropriate number of spaces to the next tab stop to 
produce the same effect as on a normal typewriter. If an 
attempt is made to tab beyond the last tab stop set, a ques- 
tion mark (?) will be echoed to signal this fact to the user, 
but a single space will be passed to the subsystem (and re- 
typed) for this tab. 



See Appendix A for a complete listing of characters that 
may not be backspaced over. 



After entering the ASSIGN processor, the remainder 
of the command is read under the class: "activate on 
punctuation, ©or ©". That is, 



! AS SIGN . 

activate on 
every character 



M:LO, etc. 
* ' 

activate on 
punctuation, etc. 



3. All the remaining Executive level command processors 
read the rest of the command under class: "activate 
on ©or©". For example, 



! SA YL 

activate on 
every character 



ALPHA, PERM© 

y 

activate on 

©or © 



Standard Input Modes 



At the subsystem/user level: d. When the BPM subsystem expects a Y or N answer, 

it reads this character in the "activate on every 

1. All subsystem input that is read through DCBs assigned character" mode. 

to the console is gathered under the activation class: „ T . rA . TI ..., .^Ar^ irvxim^-M i 

„ u . t ~ Vmi , . t ,. i /\ 3. The FORTRAN, LOAD, and SYMBOL subsystems ac- 

activate onMorw , and is prompted by a colon (:). . .. ..... ... . r . . . , 

quire all option lists and input specifications in the 

"activate on ©or ® " mode. 

2. The BPM, BASIC, EDIT, FERRET and SUPER subsystems 

read all input under the class: "activate on 0or©", 4. The machine language debugger, Delta, reads in the 

with the following exception: "activate on /, =, ©I, t , ©, or ©" mode. 
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5. BASIC SUBSYSTEM 



The BASIC sub-system is called by the Executive Command 

1 BASIC 

When ready to accept input, BASIC prompts the console 
with the ">" character, 

BASIC runs in two distinct modes: 

1. Editing - In this mode programs may be created at the 
console. A program, once created, may be saved on 
the disc file, and any previously saved program may 
be loaded for further editing or execution. The sys- 
tem is initially in the editing mode with an empty 
text area. 

2. Compilation and execution - In this mode, the pro- 
gram developed during the editing phase is compiled 
and, if no errors are detected, executed. If com- 
pilation errors are found, editing mode is restored 
automatically, and the text area will contain the pro- 
gram text just compiled. 

EDITING MODE 

LINE INSERTION 

If, following the prompt character (>), the user types a 
valid BASIC line number, followed by any non-numeric 
character , and if the line contains less than 86 char- 
acters, the line will be entered into the text edit area. 
Any line with the same line number previously entered 
into the text area will be deleted. Following this, a 
syntax check is made on the line; and, if it is not legal, 
the line is deleted. 

If more than five leading numeric digits (the first of which 
is not 0) are typed, the message 

LINE # ERROR 



will be typed preceded by the first six characters encount- 
ered in acanning the line. 

If more than 85 characters are typed on the line, the 
message 

LINE TOO LONG 

will be typed. The line will be completely ignored. 

If the syntax check uncovers any errors, the appropriate 
diagnostic message (as described in the reference manual) 
will be typed at the console. The prompt character is 
then issued and the system waits for input. Lines cannot 
be inserted when only 150 bytes of core storage remain. 

Blanks are never significant to BASIC unless they are with- 
in a pair of quotes to form a valid alphanumeric constant 
or text string, or in Image statements. 



If one tries, he gets the error message 

PROGRAM TOO LARGE 
When 500 bytes or less remain, the message 

SPACE LIMIT NEAR 

results. 

LINE DELETION 

If following the prompt, the user types a valid BASIC line 
number followed by a carriage return, the line (in the text 
editing area with that line number will be output with the 
error message; 

NO PROGRAM 

If the user wishes to start with a fresh text editing area, he 
should type CLE[ARJ followed by a carriage return. This 
will put the user level in the editing mode with an empty 
text area. Items enclosed in brackets [ ] are optional. 



The user may also type 
:L[ETE]{|; ne# 



DEI 



ne* - line* 



, line* - line 2 



]...{%} 



after the prompt, and the indicated lines will be deleted. 
The ellipsis indicates an optional multiple occurrence of 
the preceding item. If the upper form is used, and the 
designated line number(s) does not exist, the line number(s) 
will be retyped preceding the error message: 

NO PROGRAM 

If the lower form is used, all statements whose line numbers, 
n, are such that 

line* < n < line * 

will be deleted from the text area if at least one such line 
exists. If no statement numbers exist in the bounded area, 
the subsystem responds with 



line * - line 



# 



NO PROGRAM 



The printing of the NO PROGRAM error message does not 
inhibit continued processing of the line. The absence of 
such a message indicates that the specified line(s) has been 
deleted. 

If an illegal line number is encountered, i.e., one whose 
format is incorrect, the error message 

LINE * ERROR 

is printed preceded by the characters, up to six, that make 
up the line number. In this event, further processing of 
the line is inhibited. 
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If the user wishes to delete the entire program, he should 
use the CLEAR method rather than DEL followed by line 
numbers or groups that give the same result, e.g., 
DEL 1-99999. The CLEAR provides a complete recovery 
of the text space in minimum CPU time, while the latter 
method does not clean up the text edit area and requires 
much more CPU time. 



TEXT LISTING 



The user may type 

ratlin ' 



LIS 



me' 
ie j 



-line*!. I 



2-L 



ine' 
ine j 



.](!} 



This will cause a listing of the appropriate lines from the 
text editing area. Error messages identical to those de- 
scribed under "Line Deletion" are output, as appropriate. 
If the user types LIST ©, this implies that he wants all 
lines in the text area to be listed. If none exist, the 
error message 

NO PROGRAM 

will be output. 



TEXT SAVING 

The user may type 

SAV[E O] fy ER j aconst 



(followed by) 



[: 

[Jin 
[Jin 



ne w - line w _ 



ne w 
e * - line * 



{©1 

I©} 



where "aconst" is a 1-6 character string enclosed by single 
quotes or double quotes, or 1-6 non-blank characters fol- 
lowed by a blank or ® if no line numbers are given. If 
the SAVE ON form is used, a check will be made to see 
that no other file exists with the same name before opening 
the file for output. A file created by the SAVE ON me- 
thod is declared to be a TFILE and is released when the 
user logs off. 

The SAVE OVER option unconditionally writes the file, 
whether a previous file exists or not. The SAVE OVER 
option creates a permanent file provided there was no 
previously executed SAVE ON command using the same 
file. 

Both of these commands reset the account information, if 
any exists. 

PROGRAM LOADING 

The user may type 

LOA[D][aconst] {§} 

This causes the file indicated by "aconst" or the runfile 
(see below) if no "aconst" is specified to be opened and 



read completely. The processing of the information is per- 
formed exactly as previously specified for typed input 
under line insertion. Also, if the user level is in the ex- 
ecution mode just prior to typing the above iine, actions 
equivalent to those following typing of CLEAR are per- 
formed after opening the file and prior to reading any 
records. If a record which constitutes an illegal line is 
loaded, the error message 

ILLEGAL LOAD 
will be output. 
If no such file exists, the error message 

UNABLE TO OPEN 
will be output. 

LOGICAL INVERSE OF LINE DELETION 



The user may type 

ext[ract]P 



line' 
line J 



r" ne ziL' 



line 
line 



- line* 



]{|} 



This causes the deletion of all lines in the text editing area 
except for those specified by the line numbers or line num- 
ber groups. If no line numbers are specified, no opera- 
tion takes place and the prompt is issued. 

COMPILATION AND EXECUTION MODE 

While in editing mode, the user may type 

{RUN l r@i 

I FAS [T] J I© J 



This causes the entire text editing area to be copied onto 
the runfile (see below). The subsystem then enters the 
compilation mode, and the compiler is directed to compile 
from the runfile (in the safe mode, if RUN was specified; 
and in the fast mode otherwise). 

If compilation is successful, the user level is set to execu- 
tion mode; and the compiled program will be executed. 

If the compilation contained errors, the subsystem re-enters 
the editing mode, and the prompt is issued after the text 
area is restored to what was put in the runfile. 

If a FAST or RUN command is given in editing mode prior 
to the creation of any program, the subsystem will enter 
execution mode, and allow direct execution of statements 
from the console, as described below. 

Should the user's BASIC program require input from the 
user, it will prompt the console with a question mark. 

When execution is complete, the subsystem prompts with 
the character >. At this time, statements may be directly 
executed (see below) or the user may revert to editing 
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mode by typing an editing command. 

Both of these commands reset the account information, if 
any exists; and, if the standard runfile is used the pass- 
word information will be reset, if any has been set. 

MISCELLANEOUS 

ESCAPE AND PROCEED 

An ®@ unconditionally causes the input and output 
buffers to be emptied and a BREAK indicator to be set. 
Following this, the prompt is issued. If any character 
is typed at this time, the BREAK indicator is reset; how- 
ever, if the ©@ is given again before any character 
is typed, the subsystem will return to the BTM Executive. 
The ESCAPE is inhibited for the first activation tempor- 
arily during updates of the line table maintained by the 
Editor and while a file is being written because of SAVE 
requests. A second ©@ activation will never be in- 
hibited. 

Following the prompt, the user may type 

>PRO[CEED] {©] 

In this event, the user level will be restarted with the 
core (not file) conditions in effect immediately preced- 
ing the most recent ESCAPE. This service cannot be 
effective in all instances. 

DIRECT STATEMENTS 

If the user level is in the execution mode, any valid BASIC 
statement except for CLOSE, DATA, DEF, PUT, GET, MAT 
PUT, MAT GET, END, PAUSE, STOP, OPEN, DIM, 
Image, PRINT USING, FOR, NEXT, and any statement 
containing ON may be typed without a leading line 
number. This will indicate that the statement should be 
executed immediately. 

When the subsystem is in the editing mode, attempted use 
of the direct statement capability will result in the error 
message 

RUN? ILLEGAL 

The occurrence of I/O errors, or random machine or pro- 
gram failure, will cause the subsystem to print 

IRRECOVERABLE ERROR 

and revert to editing mode with a clean text area. 

FILE OPERATIONS 

For each user, there exists a preset default file name 
consisting of the characters RUNarFIL (where a repre- 
sents one of the 32 characters A, B, . . ., Z, 1, 2, 3, 4, 
5, 6)/ a will be different for each terminal, provided 
no more than 32 consoles are attached to the communica- 
tions controller. Initially the name of the runfile referred 



to above is set to this seven character string. However, 
the user may change the name of his file by typing 



NAM[E] [aconstHQ 



If an aconst appears, the name of the runfile is changed 
to the aconst. If no aconst appears, the default name is 
restored. 

In all file operations (SAVE, LOAD, RUN, and FAST), file 
name, account number, and password logic of the Batch 
Processing Monitor file management system is employed. 
Originally, the password and account number are empty. 

To establish the password or account information, the pro- 
grammer types 



(PAS[SWORD]| r . r .,f® 
lACC [OUNT]J L strmg ]l© 



where "string" extends from the first nonblank character 
up to seven characters preceding the New Line character. 
Once set, an account or password will be used in every 
operation that requires the opening of a file, except as 
specified above under "Text Saving" and "Compilation 
and Execution Mode". Also note that execution of an 
OPEN or CHAIN statement by the object program will 
result in modification of the account and password infor- 
mation. 

PRECISION OF OUTPUT 

If the programmer types 



ENT[ERBASIC][L]{®J 



the extended precision print indicator will be set or reset, 
depending on whether the optional L is or is not typed, 
respectively. 

PRINTER WIDTH 

To change the width of the printer from its default value 
of 72, the programmer types 



WID[TH] digits (!) 



where the value of the digit string, interpreted as a decimal 
integer, must be within the allowed maximum and minimum 
values of 85 and 32, respectively. 

STATUS 

To determine the status of his program at any time, the pro- 
grammer types 

[©1 



STA 



[TUS] [ @ \ 



The system will respond with one of three messages: EDIT- 
ING, COMPILING, or RUNNING, as appropriate. To 
facilitate loop detection, the RUNNING message will be 
preceded by an appropriate line number if execution was 
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interrupted while one of the instructions in the loop 
was being executed. 

SiGN OFF 

To exit from BASIC, the user should depress the @> key 
four times and wait for the Executive level prompt ( ! ). 
At this point, he may invoke another processor (e.g., 
FERRET, to allow copying of TFILE's to permanent status), 
or he may vacate the terminal by typing 



! BYE 



MODE SWITCHING 



To enter execution mode, the user must execute a RUN 
command or FAST command which produces no diagnosis 
at compilation time. Execution time diagnostics or break 
activations will be followed by a > prompt while still in 
the execution mode. 

The user may switch to editing mode by typing (after a > 
prompt has been issued) a non-direct BASIC line or any 
command that results in line deletion, text listing, text 
saving, program loading, or line extraction. 

To enter the desk calculator mode, the user may type 
CLEAR followed by RUN or FAST. 

BATCH CONTROL AND OPERATION 

To operate a BASIC batch job, the following setup in- 

1. The first record in the M:C file must be a Monitor 
UOB card. 

2. Optionally, other batch control cards (e.g., ! LIMIT, 
ISTDLB, SMESSAGE, ITITLE, SASSIGN, etc.) may 
follow in the M:C file. In particular, since any pro- 
grams that are to be invoked by execution of a CHAIN 
statement must exist as named sequential files on the 
disc, it will be natural to accomplish this setup by 
use of the FMGE system at this point. 

3. Next, the processor control card ! BASIC must appear 
in the M:C file. 

4. Optionally, the next (first) card in the M:SI file may 
be an option declaration card. This card must have 



5. 



an * character in column 1, and column 2 must be 
blank. Column 3 may contain the character S, in- 
dicating the safe mode for array references, or any 
other alphabetic character, which wiii cause the 
fast mode for array references. Column 4 may con- 
tain the character D, indicating default printer line 
width which is an assembly parameter (currently TOO), 
or column 4 may contain a digit. If neither a digit 
nor the character D is in column 4, further processing 
of the card is inhibited. If a digit appears in column 
4, successive columns of the card are scanned until 
a non-digit character is encountered. The digits are 
interpreted as a decimal integer specifying the print- 
er line width subject to maximum and minimum width 
assembly parameters (currently 131 and 32 respectively). 
The character following the D or the last digit of the 
digit string is ignored and may be any character. If 
the next character is an L, the contents of the M:SI 
file will be listed on the M:LO file. This listing will 
contain all records that follow the option declaration 
card until an end of file or a !EOD record is encoun- 
tered, or a card with the characters *RUN in columns 
1-4 is encountered. The !EOD will not be listed, but 
the *RUN will. 

The next cards in the M:SI file must constitute a 
BASIC program, i.e., a set of BASIC lines in line 
number order. 



6. If the BASIC program is followed by an !EOD record 
or a card with the characters *RUN in columns 1 
through 4, and if the compiler detects no errors, the 

... 0~,_».. r .s, a .^..,. „,„ „^ ~,w*,„,*-^ Jiuiimy 

with the statement with the lowest line number. 

7. Optionally, the next records in the M:SI file may 
contain information to be processed in response to 
execution of INPUT statements. The end of this in- 
formation is indicated by an end of file, !EOD re- 
cord, or a record with the character * in byte 1. 
Attempting to input when no more information exists 
will result in termination of execution with the OUT 
OF DATA diagnostic message. 

8. The next cards in the M:C file may be other Batch con- 
trol cards (e. g., 'ASSIGN, ! FMGE, etc.). In particu- 
lar, since all files created by execution of OPEN state- 
ments with the O option are declared to be temporary 
files (M:TFILE), the user must convert such files to per- 
manent files if he wishes to retain the information 
contained. 
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6. TERMINAL BATCH ENTRY [BPM) SUBSYSTEM 



The Terminal Batch Entry (BPM) subsystem controls inser- 
tion of jobs into the batch job queue, and is available 
only when BTM is operating in a symbiont BPM environ- 
ment. 

The Executive command for this subsystem is 

iBPM 

The subsystem will transfer a file of control and data re- 
cords from M:SI to the batch job stream. Normally, this 
file will be created at the console so that M:SI need not 
be assigned; default assignment is the user console. How- 
ever, if a job is to be repeatedly executed, the control 
records themselves may be made up as a permanent disc 
file by using the EDIT subsystem. 

The control records are formatted exactly as the control 
cards for a normal batch job. In general, any sequence 
of control and/or data records that will execute properly 
when submitted by normal means through a single device 
may be submitted through the console. A FIN control 
command, however, will be rejected. BIN control com- 
mands will be ignored, and should not be used. 

A job inserted from a terminal must be set up to run under 
the terminal's log-in account. That is, the account num- 
ber on the UOB card must be the same as the account the 
user has logged in with. 

When the job is inserted, the job ID, priority, and COC 
line number of the originating console are printed on the 
operator's log. 

Output files from background jobs may not be assigned 
directly to Teletypes, and input will normally come from 
disc or tape. 

MESSAGE Monitor control commands may be used to con- 
vey any unusual operating procedures to the operator. 

Immediately after entry, the BPM subsystem inquires 

INSERT JOB? {JQ 

An affirmative reply (Y) causes the subsystem to prepare 
to enter a job file, as described in the following sections 
on job file creation. A negative reply (N) causes the sub- 
system to go immediately to the status checking portion of 
the program. 

JOB FILE CREATION 

Input to the BPM subsystem can be from the console or 
from an existing disc file. In either case, the subsystem 
will allow some editing of the job file. These editing 
functions are intended only to provide recovery from err- 
ors of omission committed while composing a small job file 
at the console. It is strongly recommended that the user 



prepare large job files through use of the EDIT subsystem 
(see Chapter 7) prior to insertion by the BPM subsystem. 

CONSOLE INPUT 

The BPM subsystem prompts each record with a record num- 
ber. Therefore, the user creates a dialogue much like the 
following when giving commands from the console: 

!BPM 

I 

^record no. 1 (for example, UOB 85025, BPM, 1) © 

2 

: record no. 2 ® 



•.record no. n 

n+1 

j_@(A null record terminates input.) 

The subsystem then inquires 

If the reply is negative, the file is transferred to the batch 
job queue and the subsystem types the message 

JOB INSERTED. ID = xxxx 

An affirmative reply allows the user to modify his job file 
prior to batch insertion. 

DISC FILE INPUT 

After BPM is called, it will respond with the following 
request: 



?{ Y m) 



DISPLAY FOR EDITING? 



The user responds with Y or N. If the reply is negative 
(N), no further communication between user and subsystem 
takes place. The file is transferred to batch and the sub- 
system types the message 

JOB INSERTED. ID = xxxx 

The file input process may be interrupted with the © key, 
which will return the user to the Executive level. The user 
may then restart the process, or enter another subsystem. 

Should the user reply Y, the contents of the file will be 
read and displayed in the following format: 

]_BPM_ 

DISPLAY FOR EDITING? Y 

1_ 

record no. 1 
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record no. 2 



record no. n 



When the file is completely displayed, the subsystem 
prompts: 



ill) 



EDIT? 



As before, a negative reply causes job insertion. An af- 
firmative reply allows the changes described in the follow- 
ing section. 

JOB FILE EDITING 

Prior to insertion of the file, the following functions may 
be performed: 

1. Deleting any record or sequence of records. 

2. Interchanging any two records. 

3. Inserting a sequence of records. 

4. Replacing a sequence of records. 

5. Retyping any record or sequence of records. 

When the user responds affirmatively to a request to edit 
the filw, the subsystem prompts with a question mark: 

EDIT? Y 



At this point, the user may respond as follows, where xx 
and yy are record numbers as displayed on the console. 



Function 


Command 


Replace xx through yy 


? Rxx, yy 


Swap xx and yy 


2. Dxx, yy © 


Append after xx 


2. Sxx, yy © 


Terminate update, insert job file 


? G © 


Type file 


? T © 


Type xx through yy 


? Txx, yy © 


Abort the task 


? X © 



When a request is made to append or replace records, 
the program prompts with the next record number it 
expects. 

For Example: 

10 

L © 

EDIT? Y 
2A4 
5 



After insertion or deletion of records, subsequent requests 
must take into account the number of records added or 
taken, away. Edit requests are syntax checked prior to any 
action, and rejected if erroneous/ however the chance to 
the job file is made immediately thereafter. 

STATUS CHECKING 

After any job has been inserted, the subsystem inquires: 

STATUS CHECK? I^J 

If the reply is negative, the subsystem returns to the Execu- 
tive level. Otherwise, the program inquires: 

ID = xxxx © 

The user responds with the four hexadecimal digits of a 
previously inserted job. If fewer than four digits are 
entered, leading zeros are supplied. If only a carriage 
return is entered, the subsystem returns to the Executive 
level. 

After receiving a valid job ID, the program will print one 
of the following three status indicators: 

WAITING, 

RUNNING, 

COMPLETED . 

The program then issues another ID request. It should be 
noted that if a hexadecimal number is supplied that does 
not correspond to a job ID for the current symbiont run, 
the status will be as though a valid job were complete. 
There will be no error indication; therefore, the user must 
be careful to supply the proper ID. 

ERROR CONDITIONS 

Error conditions are indicated by the following messages. 



MISSING UOB COMMAND, OR RECORDS 

OUT OF ORDER. 

EDIT? 



A JOB command must be the first record transferred. After 
this message, the user should abort the task or supply the 
necessary JOB command. 



IMPROPER JOB PRIORITY; LEVEL 1 ASSIGNED 



The JOB command may not have statement continuation. 
If it contains a priority field, the priority must be expressed 
as a single character ranging from 0-F. If the JOB com- 
mand does not contain a priority field, level 1 priority 
will be assigned, with no message to the user. 



!FIN CARD IGNORED 



Records are inserted until a null record is supplied. 



The job file contains a FIN command. 



Job File Editing/Status Checking/Error Conditions 



BAD I-O. ABNORMAL CODE - xx 



An I/O error or malfunction has been detected. The sys- 
tem is returned to the Executive level. 



FILE TOO LARGE. TASK ABORTED 



The number of records that may be transmitted is limited 
only by user memory size, at 20 words per record. In a 
16K user area, this would amount«to approximately 700 
records. 



NO INPUT DATA. BYE 



The file to be transferred contains no input data. The sys- 
tem is returned to the Executive level. 



NONEXISTENT LINE 



An edit command references a nonexistent line. 



ERRONEOUS COMMAND IGNORED 



An edit command contains improper parameters. 



ILLEGAL CAL 



If the BPM subsystem is used with a non-symbiont monitor, 
the insertion of the job will abort with an erroneous CAL3 
notification. 



INVALID ID 



An erroneous job ID has been supplied. A job ID must be 
a hexadecimal number followed by a blank or carriage 
return. 



IMPROPER JOB ACCOUNT 



The job account does not match the log-in account. 



AUTHORIZATION REQUIRED 



The user is not authorized to enter a job from the terminal. 
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7. EDIT SUBSYSTEM 



INTRODUCTION 

The EDIT subsystem allows the user to create or modify disc 
resident source files. The user has the ability to: 

1 . Create a sequenced source file. 

2. Delete a record or sequence of records from an existing 
file. 

3. Insert a record or sequence of records into an existing 
file. 

4. Replace a record or sequence of records in an existing 
file with a new set of records. 

5. Reorder groups of records within a file. 

6. Perform intra-record character string substitution and 
manipulation. 

7. Copy a specified file. 

A summary of commands by function is included at the end 
of this chapter. 

The Executive command for the subsystem is 
I ED LL 

The subsystem then prompts command input with the "*" 
character. 

RECORD FORMATS 

The editing process is based on a sequence number associ- 
ated with each record. Such sequence numbers may be 
automatically generated by the Editor if not initially pres- 
ent on the file. 

Each source record is assumed to contain an EBCDIC se- 
quence number in columns 74-80. For purposes of editing, 
this sequence number has an implied decimal point between 
columns 77-78. Thus, if columns 74-80 contain 1234567, 
the sequence number is expressed as 1234.567. 

In later examples, any reference to a sequence number 
without a decimal point implies three trailing zeros. Any 
sequence number with a decimal point is assumed to have 
sufficient trailing zeros to make up three fractional digits. 
For example: 



Sequence Number 


Implies 


50 

50.01 
50.5 
50.008 


50.000 
50.010 
50.500 
50. 008 



Edit files are kept on disc with keyed organization, the 
keys being derived from the above sequence number. Since 
the Editor uses a keyed file structure, files introduced by 
BPM FMGE commands will have to be copied by the Editor 
before any editing may be performed. The user will be 
notified if this is necessary. 

In using the Editor, it mast be stressed that the edit takes 
place as the commands are given; the file is edited in place. 
Therefore, a backup file should always be kept. 

COMMAND STRUCTURE 

EDIT commands fall into the following three catagories: 

1. File oriented commands that may be given at anytime. 

2. Record editing commands that may only be given after 
a file has been selected for editing. 

3. Intra-record (usually character string) editing com- 
mands that may only be given after a specific set of 
records has been selected by- a command of type 2, 
above . 

In those commands that select files for editing, copying, 
etc., the input and output files are identified by one of 
the following constructs, called a "fid" or file identifier . 

file-name Default log-in account 

file-name (account) Specific account 

file-name (account, password) Account and password 

file-name (, password) Password only 

However, in any edit operation that writes into the speci- 
fied file, the file must be under the log-in account. The 
account specification is primarily of value for copying a 
file from a differenct account. The user is only able to 
delete files in his log-in account. 

For example: 

^DELETE BPMS (,MK) 

The command shown above specifies that the file "BPMS", 
having the password "MK", is to be deleted from the 
user's log-in account. 

Commands that reference character strings within a record 
require that the user identify the string by delimiting it 
with the "/" character. For example, the character string 
A+2 is made into a string identifier by typing /A +2). A 
single /may be included in the string by typing two slashes 
in succession. That is, /A//2/ identifies the string A/2. 

MESSAGES 

During the course of executing any command, the Editor 
may communicate with the user through a variety of 
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messages. Possible messages are summarized with the de- 
scription of each edit command. 

The following conventions are used in regard to message 
formats: 

1 . A message preceded by two periods is a comment on 
some system-oriented operation. For example: 

..COPY DONE 

2. A message preceded by two minus signs indicates the 
occurrence of some event (during the execution of a 
command) of which the user should be aware; the com- 
mand is not aborted, however. For example: 

—EOF HIT 

3. A message preceded by a single minus sign is an error 
message describing a condition which aborts the cur- 
rent command and causes any others on the same line 
to be skipped. 

Such a message may be particularized as to cause, by 
the following prefixes: 



Prefix 



-C, 



-P, 



-C P.: 
k J 



Cause of Error 



The kth command of the previous line 
caused the error. 

The kth parameter of the first command 
on the previous line caused the error. 

The jth parameter of the kth command 
of the previous line caused the error. 



For example: 

-PI: NO SUCH REC 

In addition to the particular errors discussed with commands, 
a large number of self-explanatory syntax messages are 
given when errors occur. 



The system prompts by typing a sequence number; the user 
then types in the corresponding line. A null line terminates 
the build operation and closes the file. Files created with 
BUILD are automatically permanent. 

Example: 



* BUILD SOFILE 






1.000 


SYSTEM 


SIG5 © 


2.000 


DEF 


B © 


3.000 


REF 


A© 


4.000B 


B 


A© 



5.000 
6.000 © 

1 © 



END© 

The null record, consisting of only 
a carriage return, terminates the 
command and does not appear in 
the output file. 



Comments: 

..EDIT STOPPED An EDIT was active when the 
BUILD command was given and 
has been terminated. 



Errors: 



—OVERFLOW More than 72 nonblank characters 

were entered. 

-FILE EXISTS: A file with the same fid already 

CAN'T BUILD exists. 

END (Exit) 

END causes the Editor to close all active files and return 
control to the Executive. The END command has the form 
shown below. 

^END 

COPY (Copy file) 



FILE COMMANDS 

BUILD (Build new file) 

BUILD causes the Editor to create a new file on disc. The 
BUILD command has the form shown below. 



* BUILD f 



where 
fid 



id [,n[,i]] 



is the identifier (see "Command Structure", 
above) of the file that is to be created. 

is the sequence number at which the new file is 
to start. The default value is 1 . 

is the value by which sequence numbers for the 
new file are to be incremented. The default 
value is 1 . 



Copy causes the Editor to copy a specified file. The COPY 
command has the format shown below. 



: COPYfid l{oVER) fid 2 [< n M] 



whc 



fid 1 identifies the file that is to be copied. 

f id_ identifies the file to which the file identified 
by fid, is to be copied. 

n see "BUILD" above. 

i see "BUILD" above. 

If ON is specified, a new file is created (and must not al- 
ready exist). If OVER is specified, fid2 may exist and if it 
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does it will be deleted and replaced by the copy of fid] . 
If n is omitted, the old sequence numbers on fid] are re- 
tained in the copy. If n is present, fid2 is resequenced 
starting at n and incrementing by i. 



Errors: 



Comments: 



EDIT STOPPED 



COPYING 



.COPY DONE 



Errors: 



-P2: FILE EXISTS 



-PI: NO SUCH 
FILE 

-PI: FILE NOT 
SEQD&P3 NULL 



An edit was active when COPY 
was given and has been terminated. 

The COPY has been started. 

The COPY is done. 



A COPY ONE has been given 
but fid2 exists. 

The file identified by fid] does 
not exist. 

There are no sequence numbers 
on the file identified by fid2 
and resequencing has not been 
specified; thus, if copied, the 
resultant file could not be 
edited. 



DELETE (Delete file) 

DELETE causes the Editor to delete a specified file. The 
DELETE command has the format shown below. 

^DELETE fid 

Comments: 

..DELETED The specified file has been 

deleted. 

. .EDIT STOPPED An edit file was active when 

the DELETE command was given. 



Error: 



-NO SUCH FILE The specified file does not exist. 



EDIT (Edit file) 

EDIT specifies that a specified file is to be edited. The 
EDIT command has the format shown below. 

* PHTT f.A 



This command must be given before any record oriented 
commands can be executed. The effect of the EDIT com- 
mand is terminated whenever a BUILD, DELETE, or COPY 
is given. Giving an EDIT command while a previous EDIT 
is active will cause the previous file to be closed and edit- 
ing to be begun on the new file. 



-NO SUCH FILE The specified file does not exist. 

-FILE NOT KEYED; The file is not in the correct 
keyed format needed by the 
Editor and must first be copied 
before it can be edited. 



MUST COPY 



BP (Set blank preservation mode) 

BP sets the blank preservation mode on or off. The BP com- 
mand has the format shown below. 



BP 



o 



When "on", all strings of blanks are preserved during intra- 
record operations. When "off", blank strings are com- 
pressed to a single blank or expanded as required to retain 
column alignment of nonblank fields. As discussed in 
"Intra-record Operations", below, a group of commands is 
provided that allows substitution and insertion of character 
strings within a record. This can be of great value, for 
example, when correcting a complicated FORTRAN expres- 
sion or changing the name of a variable in a program. 

However, when a string is inserted or replaced in a manner 
that changes the number of characters in a record, a prob- 
lem arises in how to adjust the record format. 

When the blank preservation mode is off, any string opera- 
tion that expands or contracts a nonblank string causes the 
blank count between the target string and the next non- 
blank string to the right of the image to be increased or 
decreased as necessary to preserve the columnar position 
of the righthand string. Nonblank strings are never con- 
nected, however; one blank will always be left between 
strings. 

When the blank preservation mode is on, the blank counts 
are preserved, as one would wish in a FORMAT or TEXT 
statement. 

For example, the following string substitution command 
(these commands are discussed later in this chapter) 

^/8/S/LINK/ 

substitutes the string "LINK" for the string "8" in the 
instruction 

$10 BAL,8 SUB 

adjusting blanks as indicated below: 



old 


$10 BAL,8 SUB 


BP-OFF, new 


$10 BAL,LINK SUB 


BP-ON, new 


$10 BAL,LINK SUB 
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Errors: 



-NOT ON/OFF 



A parameter other than ON or 
OFF was specified (the default 
is OFF). 



RECORD EDITING COMMANDS 

IN (Insert new records) 

IN causes the Editor to insert new records into a file. The 
IN command has the format shown below. 

*_IN n[,i] 

New records are inserted starting at the record with sequence 
number n, with each successive record being sequenced from 
n with increment i. If a record with sequence number n 
exists in the file, it is replaced by the newly inserted rec- 
cord n. 

The Editor will prompt the user console with the first se- 
quence to be inserted, and repeats the requests for each 
subsequent insertion, increasing the sequence number by 
the increment i. (If i is omitted, the increment size speci- 
fied in the most recent record editing command is used. If 
no such commands have been given, the value 1 is assumed 
by default.) 

The insertion can be terminated in either of two ways. If 
a null record is supplied, the insertion terminates. An equi- 
valent action takes place if an incremented sequence equals 
or exceeds a sequence existing in file. In the latter case, 
the console bell is rung. 

For example: 

*IN 100., 1 



100.000 10 A = 2.5 



100.100 



B = 0. 



Errors: 



—OVERFLOW 



Replaces the existing 
record. 



Record insertion terminates 
because sequence number 
100.200 existed previously; 
the console bell is rung. 



More than 72 nonblank 
characters were typed. 



The user wishing to insert records may use a variant of this 
command by typing IS. The action is equivalent to IN ex- 
cept the Editor does not prompt with sequence numbers. 

For example: 

MS 100, .1 
10 A = 2.5 
B=0. 



TY (Type records) 

TY causes the Editor to type each record lying within a 
specified range of sequence numbers, together with its se- 
quence number. The TY command has the form shown 
below. 

*TYn [-m] 

If m is omitted, only n will be typed. If the entire record 
will not fit on the same line with the sequence number, the 
sequence number is typed first on a separate line. Once 
the editor shifts to two-line format it will continue in that 
mode for the remainder of the range of the TY command. 



Error: 



—EOF HIT 



The range m-n passes beyond the 
end-of-file. 



TS (Type records, suppressing sequence number) 

TS causes the Editor to type each record in a specified 
range, but without an accompanying sequence number. The 
TS command has the form shown below. 



^TS n [-m] 



Error: 



— EOF HIT The range n-m passes beyond the 

end-of-file. 



DE (Delete records) 

DE causes the Editor to delete all records whose sequence 
numbers lie in a specified range. The DE command has the 
form shown below. 

^DE n[-m] 

If m is omitted, only record n is deleted. 



For example: 

* DE 50 

* DE 50-60.5 



Deletes record 50.000 only. 

Deletes all records in the range 
50.000 through 60.500, 
inclusive. 



Comments: 

—NOTHING TOPE No records were found in the 
specified range. 



Error: 



—EOF HIT 



The range n-m passes beyond the 
end-of-file. 
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FD (Find and delete) 

FD causes the Editor to search for a specified string between 
specified columns. If the string is found, the record is de- 
leted from the file. The FD command has the form shown 
below. 



* FD n [-m] , /string/[,c [,d]] 



Example: 

*FT 1-100,/LW/,10 



5.000 



9.000 



21.480 



wh« 



73.000 



n specifies the sequence number of the first record 

to be searched. 

m specifies the sequence number of the last rec- 

ord to be searched. If omitted, only record n 
is searched. 

/string/ specifies the character string identifying 
the record to be deleted. 

c specifies the lower limit (i.e., column number) 

of the field to be searched. The default value 
is I. 

d specifies the upper limit of the field to be 

searched. The default value is 72. 



The specified string must be entirely contained within col 
umns c through d to cause deletion. At the end of this 
operation, a message is printed telling how many records 
were deleted. 

Example: 

* FD 5-20 .4, /DATA/, 10, 18 

—006 RECS DLTED 
Comments: 

—NONE 

Errors: 

—EOF HIT 



There were no records (in the 
specified range) containing the 
indicated string. 



The specified range passes beyond 
the end-of-file. 



FT (Find and type) 



FT causes the Editor to search for a specified string between 
cn ^:f; /4 ,.«! ~o Tf *U„ -4...: :,. t J *U„ ej:i — *. 

*»^v.v» ■ | I \~^« ^<\>l Willi 13 • II 1IIC DIIIIIVJ IO lUUIIU^ I I IC LUtlLfl lYUCd 

out the sequence number of the record. The FT command 
has the form shown below. 



I FT n[-m], /string/ [,c[,d]J 



Comments: 
—NONE 



Errors: 

—EOF HIT 



There were no records in the 
specified range containing the 
indicated string. 



The specified range passes be- 
yond the end-of-file. 



MD (Move and delete records) 

MD causes the Editor to delete all records in a specified 
range and to then move records in another range into this 
area. The MD command has the form shown below. 

^MDn[-m],k[-p][,i] 



where 
n 



The specified string must be entirely contained within col- 
umns c through d (see "FD" above). 



specifies the sequence number of the first record 
that is to be moved. 

specifies the sequence number of the last record 
that is to be moved. If omitted, n only is moved. 

specifies the lower limit (i.e., sequence number) 
of the range of records to be deleted. 

specifies the upper limit of the range of records 
to be deleted. If omitted, k only is deleted. 

specifies the increment value to be used for re- 
numbering records. If omitted, the most recent 
increment value specified in a record edit com- 
mand is used (or 1, if no increment value has 
been specified). 



The first record (n) is renumbered as k. Successive records 
from the range n-m are renumbered consecutively higher, 
with increment i. 

As each record from the range n-m is moved, it is deleted 
from the original range (n-m). At the end of this operation, 
a message is pnnteu out speciiying tne new sequence num- 
ber of the last record moved from the range n-m. 

Example: 

^MD5-21, 100-101, .02 

—DONE AT 100.28 
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If the increment is too large to permit all records in the 
range n-m to be moved into the space between k and the 
next record after p, a message is printed out specifying the 
sequence numbers, from both ranges, of the last record 
moved. 

In this case the original contents of range k-p will be lost, 
but only those records in the range n-m which have actually 
been moved will have been deleted. Thus the user can per- 
form another move (with a smaller increment) to move the 
remaining records in the range n-m. 

Example: 

*MD 10-30, 100-110,1 

—CUTOFF AT 110. (20.) 



The ranges n-m and k-p may not overlap. 
Errors: 



--NOTHING TO MOVE 



— RNG OVERLAP 



--EOF HIT 



No records exist in the 
range n-m. 

Ranges n-m and k-p 
overlap. 

Range n-m passes beyond 
the end-of-file. 



MK (Move and keep records) 

MK acts similarly to MD except that the records in the 
range n-m are not deleted as they are moved, rather a 
second copy of the range n-m is made. 

The MK command has the form shown below. 

*_MK n[-m],k[-p][,i] 

RN (Renumber record) 

RN causes the Editor to renumber specified records. The RN 
command has the form shown below. 

^RN n,k 

This has the same effect as deleting record n and then enter- 
ing a new record with sequence number k with the same con- 
tents as n. Sequence number k must not already exist. 

Errors: 

-PI: NO SUCH REC Record n does not exist. 

-P2: REC EXISTS Record k already exists. 

CM (Commentary) 

CM causes the Editor to insert commentary into specified 
columns of each successive record beginning at a specified 



sequence number. The CM command has the format shown 
below. 

* CM n,c 



n is the record number, 

c is the column number. 

The sequence number of each record is typed and then the 
user types in the data he wants inserted starting at column 
c. The data he types in is blank filled to the right through 
column 72, as required. A null record terminates the com- 
mand. It is not necessary to delimit commentary with slashes. 

Example: 

* CM 37.6, 40 © 

37.600 COMMENT 1 © 

37. 800 COMMENT 2 © 

40.500 © 



Errors: 

-P2: CQL>72 

-PI: NO SUCH REC 

—EOF HIT 

—OVERFLOW 



Column c > 72. 

Record n does not exist. 

The end-of-file has been 
encountered. 

Commentary typed in has over- 
flowed past column 72 with non- 
blank characters. 



SS (Set and step) 

SS causes the Editor to start at a specified record and pro- 
ceed to each record in succession, accepting one line of 
intra-record commands to update the current record. The 
SS command has the format shown below. 



*_SS n[,c[,d]] 



Intra-record commands will only be effective on strings that 
lie wholly within columns c through d. 

The Editor prompts commands for each successive record with 
the sequence number, followed by a double asterisk. 

The SS command is terminated by typing a null record in 
place of an intra-record command. 

Example (to interpret this example in detail, see the com- 
mands discussed in "Intra-Record Operations", below): 

*SS 300.5, 37© 

300 .500** /BSD/S/BAD/ © 

301.Q00** 37EA/© 
303.450** p) 
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Errors: 



-PI: NO SUCH REC Record n does not exist. 



—EOF HIT 



The end-of-fiie was 
encountered. 



Commands input will be applied, in order, to each record 
in the range n through m. If several commands are entered 
on one line, all commands on the line are executed on one 

rence of a file or record oriented command (e.g., IN) ter- 
minates the effect of the SE command. 



-Cn: COMND 
ILGL HERE 



The nth command of the input 
line is not an intra-record com- 
mand; the "set and step" mode 
is terminated. 



ST (Set, step, and type record) 

This command is similar to SS except that the contents of 
each record are typed, along with its sequence number, 
prior to accepting a command. The ST command has the 
format shown below. 

*ST n [,c[,d]] 

Example: 



*ST50© 



50.000 XQ1 



LW,5 



AGRD,6 



** NO © 
51.000 



STW,5 



*KX9 



!lA/F/1/;TS© 

STW,5 *KX19 



52.000 



MW,8 



BQ 



** r\ 



INTRA-RECORD OPERATIONS 



Commands in the intra-record group may be concatenated 
on a single line through use of the ";" character. The fol- 
lowing command sequence would select a line, type the 
original, edit, and type the new version: 

^_SE 100 ; TY ; /TEMP/S/B/;/JK/F/+BETA/;TY © 

Prior to performing any of the operations described in this 
section, the user must either give an SS or ST command 
(which provide for step mode modification of successive 
images) or the following SE command which allows repeated 
modification of the same range of images. 



SE (Set intra-record mode) 

SE causes the Editor to accept successive lines of intra- 
record commands. The SE command has the format shown 
below. 



^SE n[-m][,c[,d]] 



All commands executed in the intra-record mode apply only 
to the strings lying entirely within columns c through d. 
Each new input line of commands will be applied to the 
whole range (n-m). 

SE may be used on the same input line with other intra- 
record commands, but when so used it must be the first 
command on the line. 



Errors: 



—EOF HIT 



-PI: NO SUCH REC 



The range n-m passes beyond 
the end-of-file. 

Record n does not exit. 



The following conventions are used with intra-record 
commands: 

1 . j/string/x 

means that command x is to operate on the jth occur- 
rence of the indicated string found between columns c 
through d as specified by an SE, SS, or ST command. 
If j = this means that the command x is to operate on 
all occurrences of the string between columns c and d. 

11 J 



_• _• iL- _i_r_.-ijL 

iniSsiiry, me uciuuii 



2. kx 

means that command x is to operate on the character 
contained at column k, where k must lie between col- 
umns c and d of the SE, SS, or ST command. 

The following general errors are possible: 



-MISSING SE 



No SE command was given. 



-Cn: NO SUCH STRG The string referred to by the 
nth command of the input 
line does not exist between 
columns c and d. When the 
SE command operates on a 
range of lines, this message 
will be given once, should 
the condition occur at any 
time during scanning of the 
range. 



— Cn: COL>LIMIT 



~Cn:COL<LIMIT 



Tne vaiue specified for k is 
greater than d for the nth 
command. 



The value specified for k is 
less than c for the nth 
command. 
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In any infra-record command that seeks a matching string in 
the image, only those strings that lie totally within the spe- 
cified column bounds will be found. Partial matches to a 
column boundary will be ignored. In subsequent examples, 
references to columns c and d pertain to the column bound- 
aries given in the SE, SS, or ST command. 

S (String substitution) 

S causes the Editor to locate a given occurrence of a speci- 
fied string between columns specified by an SE, SS, or ST 
command and replace it with another string. The S command 
has the format shown below. 

*_[]]/ string j /S/stringg/ 

The image to the right of string] is adjusted right or left as 
required, if the lengths of string] and string2 differ. String2 
may extend past column d if d < 72. 

If j = is used, all occurrences of string] between columns 
c and d are replaced by string2; otherwise, only the jth 
occurrence is replaced. 



Error: 



— Cn: OVERFLOW Nonblank characters have been 
pushed off the right end of the 
card image by the action of the 
nth command. 



For example: 



Command 


Result 


*/LW/S/CW 




LW,R5 ALPHA+2 
CW,R5 ALPHA+2 


old 
new 


yio/s/5/ 




LW,R10 B 
LW,R5 B 


old 
new 


*/$10/S/ENTRY 


$10 
ENTRY 


LW,R5 ALPHA 
LW,R5 ALPHA 


old 
new 


*/ALPHA/S/B/ 




LW,R5 ALPHA+2,R6 
LW,R5 B+2, R6 


old 
new 


*2/5/S/55/ 


15 
15 


C=DSQRT(TEMP+ 
2. 5* BASE) 

C=DSQRT(TEMP+ 
2. 55* BASE) 


old 
new 



D (Delete string) 

D causes the Editor to locate a given occurrence of an indi- 
cated string, between columns specified by an SE, SS, or ST 
command, and delete it. The D command has the format 
shown below. 

*[j]/string/D 

If ] = 0, all occurrences between c and d are deleted. 



E (Overwrite and extend blanks) 

E causes the Editor to start at the column occupied by the 
1st character of a given occurrence of a specified string or 
column and overwrite with another string. The E command 
has the format shown below. 

2[j]/string 1 /E/string 2 / 



j^kE/string-/ 

Blanks are extended from the end of string2 through column 
d. String2 may overwrite beyond column d if d < 72, but 
blank extension only occurs through column d. 



Error: 



-Cn: 'ALL' IGNORED The specification j - was 
used, but since it was not 
meaningful for E, ] = 1 was 
substituted. 



—Cn: OVERFLOW 



String2 overflowed past column 
72 with nonblank characters. 



(Overwrite) 

O causes the Editor to start at the column occupied by the 
first character of a given occurrence of a specified string 
(or column) and overwrite with another string. No blank 
preservation or other adjustment is done and all columns not 
overwritten remain unchanged. The O command has the 
form shown below. 



^[jj/stringj/O/string^ 



*_kO/string 2 / 

String2 may overwrite beyond column d if d < 72. If ] = 
all occurrences of string] between columns c and d are over- 
written, but string2 is not scanned while searching for oc- 
currences of the first string. 



Error: 



«Cn: OVERFLOW 



Nonblank characters have 
overflowed beyond column 72. 



P (Precede by) 

P causes the Editor to start before the first character of a 
given occurrence of a specified string (or column) and in- 
sert another string, pushing characters of the first string to 
the right as required to make room. The P command has 
the form shown below. 

I []]/ strIn g]/ p Afring 2 / 

or 

*_kP/string 2 / 
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String2 may legally extend beyond column d if d < 72. The 
first character of string2 will occupy the column vacated by 
the first character of string j, etc. 

If j = 0, the Editor will insert string2 before all occurrences 
of string^ between columns c and d. However, after string] 
has been found once and string2 inserted before it, scanning 
for the next occurrence resumes at the next character after 
string], as adjusted by the insertion. 

Example: 



*SE 17.69© 
*TS;0/AA/Ty./;TS ® 
AAAAAAA 



.AA.AA.AAA 



Errors: 

— Cn: OVERFLOW A nonblank character has been 
pushed off the right of the card 
image. 

F (Follow by) 

F causes the Editor to start after the last character of a 
given occurrence of a specified string (or column) and insert 
another string, pushing everything from this column right as 
required to make room. The F command has the format 



*[j]/string 1 /F/string 2 



^kF/string^/ 

String2 may legally extend past column d if d < 72. String2 
is not scanned when searching for all occurrences of the 
first string. Furthermore, insertion is made from left to right, 
so that an occurrence of string] which was between columns 
c and d before F was executed may no longer be in this 
range by the time it is scanned, if previous insertions have 
taken place. 

For example: 



Command 


Result 


VAB/F/+2/ 


LW,R6 AB,R2 old 

LW, R6 AB+2, R2 new 

i 



Errors: 



—Cn: OVERFLOW 



Nonblank characters were 
pushed off the right-hand end 
of the record image. 



R and L (Image shifting) 

R and L commands cause portions of the image to be shifted 
rjnh.t ($) or left (V*. The R and L commands have the form 
shown below. 



:[j]/str!ng/ {[} 



CI 



SHIFT LEFT 

The nonblank field to the right of the first character of the 
jth occurrence of the indicated string (or column k) is 
shifted left s positions. Blanks are supplied on the right, 
and columns to the left are overwritten. The shift may 
legally overwrite below column c. 

SHIFT RIGHT 

The nonblank field to the right of the first character of the 
indicated string is shifted right s positions. Blanks are in- 
serted into vacated positions and absorbed on the right if 
blank preservation is OFF. The shift may legally push 
characters beyond column d, if d is less than 72. 

For example: 



r i 

V^WIIIIIIUI IU 


D 1 


1" 






*AA2 


$10 


LW,R6 


B 


old 




$10 


LW,R6 


B 


new 


*/L/RlO 


$10 


LW,R6 


B 


old 




$10 




LW, R6B 


new 


*/L/L2 


$10 


LW,R6 


B 


old 




$10 


LW,R6 


B 


new 



Errors: 



— Cn: 'ALL' IGNORED The value j=0was specified, 
but j = 1 was substituted. 

— Cn: UNDERFLOW Characters were lost to the 

left of the record. 



--Cn: OVERFLOW 



Characters were lost to the 
right of the record. 



TS fTvne £iinnre<cinn »nnpnri> nnmhorl 

•- \ - / r - r --l-l--*- 3 1 / 

TS causes the Editor to type the contents of the current 
active line of the SE, SS, or ST command. 

The TS command has the form shown below. 

• ;]TS [;...] 
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Example: 



^SE 5 ; TS© 

LI LW,5 K 

*_ 190/KLB/ ; TS; 370/GET KLB/ ; TS © 

LI LW,5 KLB 

GET KLB 



LI LW,5 



KLB 



Because all commands on a single input line are executed 
for the first record before the second record is processed, 
etc., TS will type each line in turn after all editing up to 
the TS command has been done. 



Example: 



1ST 27.5 © 
27.500 



LW,6 



** NO © 
30.000 



STW,6 



34.000 



AI,F 



BLK 



ALT 



^/ALT/F/+/19/ ; TY ; JU34 © 

30.000 STW,6 ALT+19 



X'91 1 



Example: 






* SE 10-10.2© 






12/A/F/,4/;TS© 






DATA, 4 


X'FF' 


(10.0) 


DATA, 4 


0,5 


(10.1) 


DATA, 4 


GQX,X'0B' 


(10.2) 



TY (Type, including sequence number) 

TY is the same as TS, except that each line is printed with 
its sequence number. 



JU (Jump) 

JU may only be used while in the "step" mode (i.e., while 
under the control of an SS or ST command). JU causes the 
SS or ST command to jump to a specified record and then 
continue stepping from that point. The JU command has 
the form shown below. 



-["•'] 



JUn 



Record n may be forward or backward from the current 
sequence number at the time JU is given. JU may be used 
on compound lines (i.e., a line with more than one com- 
mand on it), but in such a case JU must be the last com- 
mand on the line. 



Error: 



— Cn: NO SUCH REC 



Record n does not exist. 



NO (No change) 

NO may be used only while in the "step" mode and speci- 
fies that no editing is desired on the current active line 
under the set. The NO command has the form shown below. 



NO 



RF (Reverse blank preservation flag) 

RF causes the current setting of the blank preservation flag 
("on" or "off") to be reversed temporarily. The RF com- 
mand has the form shown below. 

![...;] RF;... 

or 

^...;RF [;...] 

The flag is reversed only for the duration of the input line 
in which RF appears, and blank preservation is restored to 
its initial setting when a new input line is entered (i.e., at 
the time a new prompt character is given). Thus, RF must 
always be used as part of a compound input iine to have 
any effect. 

Example: 

^SE 10; TY 

10.000 L5 LW,4 X GET CURRENMT ADDR 

*_ RF;/NM/S/N/;TY 

10.000 L5 LW,4 X GET CURRENT ADDR 

Without using RF in this case (assuming that BP OFF is the 
initial setting), one would get two blanks after CURRENT. 
In all cases, the BP flag is restored to the value it had 
before any RF commands were given. 

EDIT COMMAND SUMMARY 

A summary of EDIT commands is given below. 
Command Page Function 



BP 


20 


Select character inseri 


BUILD 


19 


Create new file 


COPY 


19 


Copy file 1 to file 2 


DELETE 


20 


Delete file 


EDIT 


20 


Select file for editing 
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Command 


Page 


Function 


END 


19 


Exit to Executive 


CM 


23 


Insert commentary 


DE 


21 


Delete records 


FD 


22 


Delete records cor 



specified character string 

FT 22 List sequence numbers of 

specified character string 

IN (also IS) 21 Insert records 

MD (also MK) 22,23 Reorder records within file 

RN 23 Renumber record 



Command Page Function 

ST (also SS) 24 Perform character operations on 

recorus in siep moue 

TY (also TS) 21 Type individual records 

SE 24 Perform character operations on 

group of records 

R or L 26 Shift string 

S 25 Substitute string 

D 25 Delete string 

O (also E) 25 Alter string 

F,P 25,26 Insert string 
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8. FERRET SUBSYSTEM 



FERRET is a utility subsystem providing a general capability 
for obtaining information about entries in the file manage- 
ment system. The subsystem also provides for limited file 
manipulation. 

FERRET is called with the Executive command 

! FERRET 

and when ready to accept input, prompts with the ">" 
character. 



If the file is accessible, the following message is printed: 

file name WAS CREATED monfh,day,year,AND HAS 
xxxx GRANULES IN IT . 

If the file does not exist or cannot be accessed under the 
user's account or the password specified, the following 
message is given: 

CANNOT ACCESS FILE file 



Any FERRET commands may then be given. If the subsystem 
does not recognize a command, it responds with 

COMMAND NOT LEGAL. 



The user may exit to the Executive by typing an X, 



i.e., 



>X 
I 



At any time, ©@ may be used to exit to the Executive 
level. The PROCEED command, at that point, will con- 
tinue the previous operation. 



FERRET COMMANDS 

LIST (List account contents) 

LIST causes the program to list all file names in the 
specified account. If no account number is specified, 
the log-on account is used. The LIST command has the 
form shown below. 

> L[lST][acct.]@ 

TEST (Test file accessibility) 

TEST checks whether the user may read the specified file(s) 
under his log-in account. 

The TEST command has the format shown below. 

>T[EST]file[,file,...,file] ® 
where 

file may have any of the three following formats: 

1. name User's acct. assumed. 

2. name (acct.) Specified acct. 

3. name (acct. , pass.) Specified acct. and pass. 



ACTIVITY (Check file activity) 

The file specification formats are as in "TEST", above. These 
files are checked for current activity by attempting to open 
them in the INOUT mode. A discussion of such modes is 
contained in the BPM Reference Manual, 90 09 54. If the 
file can be opened, if is inactive and the program prints 

file IS INACTIVE 

The ACTIVITY command has the format shown below. 
^A [CTIVITY] file[,file, . . .,file] © 

If the file cannot be opened, it is either currently open 
or the user does not have write access to the file, and in 
either case the file is considered active. The program prints 

file IS ACTIVE 



Should any of the indicated files not be accessible to the 
user as described under file accessibility, the CANNOT 
ACCESS FILE message will be given. 

DELETE (File deletion) 

If the user may access the file (see "TEST", above)and it is 
in his log-in account, the file will be deleted. 

>D[ELETE]file[,file,...,file] © 

If the user may not access the file, or it is not in his log-in 
account, the file will not be deleted and the following mes- 
sage is given. 

CANNOT DELETE FILE file 

COPY (Copy file) 

COPY copies file, to fileo. It has the format shown below. 
>C[OPY]file 1 ,file 2 ® 

If file] is not accessible to the user (see "TEST", above), the 
CANNOT ACCESS FILE message is given. If file2 cannot 
beopened in the output mode, the following message isgiven. 

CANNOT CREATE FILE file 
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FERRET can copy records up to 512 words in length. A 
larger record causes the copy to be aborted with the message 

CANNOT COPY - - RECORDS TOO LARGE 



EXAMINE (Examine file) 

Should the file not be accessible (see "TEST", above), the 
appropriate message will be given. EXAMINE has the for- 
mat shown below. 

>E[XAMINE] file © 

Since a number of actions are possible in connection with 
EXAMINE, the subsystem will prompt with the * character. 
For example, 

> E ALPHA ©(examine file ALPHA) 



The following characters cause the indicated action. 

* X © Exit from file examination mode. 

* N © Display, in decimal, the number of 

records in the file. 



* m © Print record m in EBCDIC. 

* m,n © Print records m through n in EBCDIC. 

In any of the print commands, above, typing H as a first 
character causes the print to be in hexadecimal, with four 
words of the record per line. Lines of zeros will be sup- 
pressed. For example, 

#H20© 

causes a hexadecimal dump of record 20. 

Records larger than 512 words will be truncated to 512 with 
the following message. 

RECORD EXCEEDS BUFFER SIZE, 512 WORDS GIVEN 

If the first record requested is not in the file, the following 
message is given. 

FIRST RECORD NON-EXISTENT 

If an end-of-file occurs before the last record requested, 
the dump is terminated with the message 



UNEXPECTED EOF AFTER RECORD 



# © 



Print all records in the file in EBCDIC. 



where j is the highest record number read. 
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9. FORTRAN IV-H SUBSYSTEM 



The FORTRAN compiler processes FORTRAN source lines 
(see SDS Sigma 5/7 FORTRAN IV-H Reference Manual, 
90 09 66) in the order in which they are read. It is im- 
portant that the source program (input through M:SI) be in 
an order acceptable to the compiler. 



FORTRAN OPTIONS 

When the FORTRAN subsystem is called, it responds with 
a request for options. The user types an option list in 
which the options are separated by commas, and the list is 
terminated by a carriage return. Any time prior to typing 
the carriage return, a user may enter ©X to erase the 
entire option list, and then enter a new one. 

The following table lists all the forms of each option. The 
underlined options are the default options, used when only 
a 0is given in response to the OPTIONS request. Should 
the user type an option request, he receives only those he 
requests. 



Opl 


■ion Form 


Description 


Wanted 


Not Wanted 


BO 


NOBO 


Binary Output file. Ouput 






through M:BO. 


!_S 


NOLS 


List Source. Each source 






statement is output through 
M:LO. 


SO 


N'OSO 


Source Output. Source card 
images will be output through 
M:SO. The SO option allows 
the creation of a permanent 
source file while compiling 
from the console. It is not 
honored when input is from 
the RAD. 


DB 


NODB 


Debug, Basic. Causes the 
binary output (BO) to be cre- 
ated with links to the basic 
run-time debug package (see 
"FORTRAN Execution with 
Debug Option"). If DB is re- 
quested, BO is assumed and 
need not be requested. 


S 


NOS 


Symbolic machine language 
instructions may be written 
within FORTRAN source pro- 
grams. (For details on format 
and usage, see Appendix B, 
SDS Sigma 5/7 FORTRAN 
IV-H Operations Manual). 



Note that if any errors are encountered during compilation, 
they will unconditionally be printed along with the offend- 
ing source lines, through M:DO. If M:LO is assigned to a 
different file than M:DO, the error lines and messages 
will also be output through M:LO (even if no listing was 
requested). 

The default assignments of all the DCBs used during com- 
pilation are as follows: 



DCB 


Default Assignment 


M:BO 


File named BOTEMPo'. 


M:DO 


The user terminal. 


M:LO 


The user terminal. 


M:SI 


The user terminal. This means that a user 




should be careful to type his source in the 




proper columns. The TABS Executive com- 




mand greatly simplifies this. 


M:SO 


File named SOTEMPa. 



The sequence of events during compilation is: 

1. The source lines comprising a statement are input 
through M:SI and scanned. 

2. If an error is found in the statement, the statement, 
followed by an error message, is unconditionally 
printed through M:DO and also output on M:LO (if 
different from M:DO). 

3. If no error is found and the listing option has been 
given, the source statements will be printed through 
M:LO. 

4. For each source statement free of error, the compiler 
will generate the code in SDS standard object language 
and output through M:BO. If DB has been requested, 
each statement will also have a link generated to the 
run-time debug package. 

5. When an END statement is encountered, the compiler 
prints a program summary (if LS was requested) and 
completes generation of the relocatable object module 
through M:BO. 

6. When compilation is complete, the compiler returns to 
the BTM Executive. A compilation may be interrupted 
via ©©if the user desires to change ASSIGNments or 
options. To continue the compilation, give the Execu- 
tive command PROCEED. Upon re-entering the com- 
piler, the user will receive another request for options. 
If he does not wish to change from his previous selec- 
tion of options, he merely types a ©(the assumed 
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options become whatever he chose at the beginning of 
the compilation). However, any changes desired in 
options may be made at this time. Users should not try 
to select either BO or DB in the middle of compila- 
tion when NOBO and/or NODB were requested 
initially, because the resultant object module will not 
be executable. 

7. The normal manner in which to create and debug FOR- 
TRAN programs is to use the Editor to first create the 
source file; then compile, load, and execute. 

However, it is possible to type a program directly to 
the compiler, a line at a time, while using SO to cre- 
ate the source file. The following error recovery pro- 
cedure exists in the compiler for use by the experienced 
FORTRAN programmer wishing to create a small program 
directly from the console. 

Since the FORTRAN language denotes continuation by 
putting the continuation flag in the card that is the 
continuation, a compiler must always read ahead one 
card to see if the source line it just read was continued. 
For the on-line user compiling from the console, this 
causes him to have to input a line following any com- 
plete statement to denote the end of that previous state- 
ment thus getting any diagnostics a line later. When 
using the compiler in this direct manner, a user should 
(but need not necessarily) type a colon as the last non- 
blank character before his©. The colon will signify 
that no continuation lines follow, so analysis will take 



place immediately and diagnostics will be output as 
follows, without the user having to type in another line. 

a. After the error is printed, and if M:SI is assigned 
to the console, a retry request is given to the user. 
If he does not wish to re-enter his erroneous state- 
ment, then compilation will continue. 

b. If the user wishes to retry, he may input a new set 
of lines comprising the replacement for the state- 
ment. Upon termination of this set of lines, the 
statement(s) are compiled. 

c. If the retry statements) has no errors, then the 
compiler will check to see if a source line was 
input after the last line of the original statement. 
If so, the line will be output on the Teletype and 
the user will be requested to accept or reject it. 
If he accepts it, compilation continues; if he re- 
jects it, a new record is read from the console and 
compiled. If there was no source line input after 
the original statement due to the ":" convention, 
regular compilation will continue. 

d. If the retry statements) contains errors, the series 
of events is exactly the same as (a) - (c) above. 

When obtaining source output from the compiler, the edit 
sequence number is implicitly k.000; where k is the state- 
ment number of a line typed to the compiler. 



t-Xunfipm i 



! FORTRAN 








Select FORTRAN. 




OPTIONS: 


© 






Default options - BO, LS, SO, NODB, NOS. 




I: 




A = B: 


© 


Source line I by user (with a "no continuation" mark). 




2: 




C = D 


© 


Source line 2 by user (it may be continued). 




3: 




E =F: 


© 


Source line 3 by user (with a "no continuation" mark). 




4: 




G=H 


© 


Source line 4 by user (it may be continued). 




5: 




END 


© 


Source line 5 by user (because it is an END statement, 


it is assumed 










to have no continuation). 




SUBPROGRAMS 


















Program summary. 




PROGRAM END 











Example 2. 



[FORTRAN 




Select FORTRAN. 


OPTIONS: © 




Default options 


1_: 


A = B,P: © 


Source line 1, with error. 
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1: 



A = B,P 



****SYNTAX 

RETRY? 1: A = B*P © 

MORE? © 

2_: C = D © 

3: END © 



Diagnostic 

User retries 
End of user retry 
Continue normal input 



Example 3. 



[FO RTRAN 

OPTIONS : © 

]_: A = B,P © 

2 : C = D © 

U A = B,P 

****SYNTAX 



RETRY? 1 : A = B*P © 
MORE? 2: © 
ACCEPT? 2: C = D © 

3: END © 

SUBPROGRAMS 

PROGRAM END 



Standard options - LS, BO,SO,NODB, NOS. 
Source line 1 by user. 
Source line 2 by user. 

Diagnostic on source line 1. 

Retry request for source line 1, user retries. 

Request for additional source lines on retry, but user has none. 

User asked to accept previously input line. Y©or ©means yes; 
N © is no. 

End of program. 
Program summary. 



Example 4 



! FORTRAN 




OPTIONS: © Standard options. 


1: A = B,P © S 


ource line 1 by user. 


2: A = B*P © 3 


ource line 2 by user. 


1: A = B,P 




$ 


" Diagnostic on source line 1. 


****SYNTAX 
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RETRY? 


1: B= 1. ® F 


,etry request for source line 1, user retries. 




MORE? 


2: P = 3.7 © User types additional line in retry mode. 




MORE? 


3: © No more retry lines. 




ACCEPT? 


3: A = B*P © User accepts previous input (resequenced as source 


line 3). 


4: 


C = A*P ® Source line 4 by user. 




5: 


END © Source line 5 by user. 




SUBPROGRAMS 




► Program summary. 




PROGRAM END 


> 







EXECUTION OF FORTRAN PROGRAMS 

All object modules (BO) created by the FORTRAN compiler 
must be loaded by the Loader subsystem. The Loader will 
build DCBs for the SDS standard unit numbers (101, 102, 103, 
104, 105, 106, and 108) and for any other DCBs that have 
been referenced by an ASSIGN command prior to entering 
the Loader subsystem. 



SDS Standard 


Correspond- 


Default 


Unit Number 


ing DCB 


Assignment 


101 


F:101 


Users terminal 


102 


p.ino 


Users terminal 


103 


F:103 


Users terminal 


104 


F:104 


Users terminal 


105 


F:105 


Users terminal 


106 


F:106 


Users terminal 


108 


F:108 


Users terminal 



All FORTRAN I/O statements refer to unit numbers, and 
there must be a DCB (F:u, where u = unit number) for each 
unit number used. If I/O is performed only via the FORTRAN 
II type READ/PUNCH/PRINT statements, then all DCBs will 
be provided (READ references F:105, PUNCH references 
F: 106, and PRINT references F: 108). However, if a user 
writes on any unit besides SDS standard units, he will have 
to make a request during loading of his program to define 
the corresponding DCB. 

Example: 

(FORTRAN statements) 

WRITE (6, 10)A,B,C 

10 FORMAT (3F10.4) 



When the Loader has completed loading the program it will 
issue a request for the user to give the name of any nonstan- 
dard DCBs to be used. The user might respond 

f_:6 = MINE © 

f_: © 

This causes the DCB, F:6, to be built and included with the 
user's program. F:6 is assigned to a file name MINE. The 
second line beginning with F: terminates the requesting of 
DCBs (see Loader subsystem for a discussion of DCB requests). 

Example: 



(FORTRAN statements) 





READ 


(2,10) 


I 




READ 


(3,12) 


J 




READ 


(4,10) 


K 




READ 


(5,11) 


L,M 




WRITE 


(6 J 3) 


I 




WRITE 


(7,14) 


J 




WRITE 


(8.15) 


K,L,M 


10 


FORMAT 


(110) 




11 


FORMAT 


(614) 




12 


FORMAT 


(317) 




13 


FORMAT 


(2HI=,I10) 




14 


FORMAT 


(1H 1,515) 




15 


FORMAT 


(6120) 





• Corres n ondin ri requests for DGBs^ 
fj2 © 

h3 = DATAl,IN © 

h4 = DATA2 (ACCT3), IN © 

fj5 = DATAl, IN © 
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F:6 = OUTl, L © 

Fj7 = OUT2 (ACCT3), OUT, L © 

h8® 

F:© 

The result of these assignments is as follows: 

F:2 is assigned to the user's console. 

F:3 is assigned to an input file named DATA1 . 

F:4 is assigned to an input file, DATA2, in the 

account ACCT3. 

F:5 is assigned to the input file DATA1 (same as 

F:3). 

F:6 is assigned to the file OUT1, which is a 

listing (L) file. 

F:7 is assigned to the file OUT2, in the account 
ACCT3, which is an output (OUT) listing (L) 
file. 

F:8 is assigned to the user's console. 

F^ © terminates the list of DCB definitions. 

FORTRAN EXECUTION WITH DEBUG OPTION 

The FORTRAN compiler offers two kinds of source-language 
debugging capabilities. One capability provides a trace of 
the numbers of source lines reached during execution of a 
program. The other capability traces the values stored into 
variables as the result of assignment statements. A special 
code will be generated into the user's program to provide 
these debugging features if the option is selected. 

The DB (debug) option, specified in the FORTRAN option 
list, causes FORTRAN to generate the necessary linkage to 
allow the debugging capabilities. At run time, a program 
compiled in debug mode enables the user to trace program 



execution, request a snapshot dump, halt execution at a 
particular statement, and to execute this program in the step 
mode (i.e., the program will halt after the execution of 
each statement). The following discussion assumes that the 
object program was compiled in the debug mode. 

After the program has been loaded into core storage for 
execution, the program identification is typed by BTM: 

# MAIN 

BTM then types an asterisk on a new line. The debug codes 
given in Table 1 will be accepted as input. In this table 
default values for the debug codes are underlined. 

Each acceptable input code is acknowledged by a ® . If an 
input code cannot be recognized, a question mark (?) is 
typed instead of the ©. 

The size of FORTRAN programs that may be loaded and exe- 
cuted is limited only by the size of the time-sharing envi- 
ronment. Since the Loader must be able to fit in core with 
the user program during load, the total loadable FORTRAN 
program size in a 16K on-line area is approximately 8000jq 
words, not including the library. Total program size of 
FORTRAN programs is printed on each compilation summary. 

The diagnostic comments at compilation time are described 
in Chapter 2 of the SDS Sigma 5/7 FORTRAN IV-H opera- 
tions Manual (90 11 44). 



FORTRAN-LIBRARY/RUN-TIME DESCRIPTION 

All basic external functions and subprograms available in the 
FORTRAN IV-H library are described in the SDS Sigma 5/7 
FORTRAN IV-H Operations Manual (90 11 44). 



Whenever an error is detected during execution, a diagnos- 
tic message is written through M:DO (and M:LO, if a dif- 
ferent file). For a list of all possible diagnostics and their 
meaning, see the SDS Sigma 5/7 FORTRAN IV-H Operations 
Manual (90 11 44). 



Table 1 . Debug Codes 



Code 



Meaning 



S © 

NS © 
T © 

NT © 



Step. The program is to be executed in the step mode. Before each statement is executed, its statement 
number is typed. This is followed by a carriage return and asterisk, and an input code is expected. 

No step. This input code terminates the step mode. 

Trace. Trace the source lines reached during program execution. Before being executed, the statement 
numbers are printed, through M:DO, across the line (up to column 80) and are separated by blanks. 

No trace. This input code terminates the trace. 
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Table 1. Debug Codes (cont.) 



Code 



Meaning 



V © 



NV © 
Adddd ® 



NA © 
G © 

R © 
NR © 

i rUuuuuu 

NH © 



Snapshot. A snapshot displays the values tored into variables as the result of assignment statements. 

A snapshot is of the form: 

variable name = constant (for scalars) 

variable name (element number) = constant (for arrays) 

The value of the constant is printed through M:DO in a format that corresponds to the type of the 
variable. 

No snapshot. This input code terminates the snapshot. 

Stop. The program is to stop each time it reaches line "addd. When line "addd is reached, the program 
types: 

STOP AT dddd 

and halts. On a new line, an asterisk is printed and any of the Debug input codes may be entered. When 
a G code (see below) is entered, program execution proceeds, beginning with statement dddd. 

No stop. The program will no longer stop at the statements previously designated by the A (stop) code. 

Go. The program begins execution, and the indicated debug function are performed at the appropriate 
times. This code is the only one that does not result in a new input request. 

Do not stop at lower levels of subroutine entry. Suppresses printing of subroutine name. 

Stop at subroutine entry. 

u_Ijl i.. _„j._. i... iU_ ...I i.: c j.? i wzjocJCXX. " / i l_ -.11 _..l \ 

mum umy upuii cimy iu mic luuiuuimc ui iuii^i iuii iiumicu uuuvuv \ua uppuscu iu uii suupi uyi vjiiis/ . 

Halt at all subprograms. 
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10. LOADER SUBSYSTEM 



The Loader subsystem loads SDS Sigma 5/7 Standard Object 
Language programs comprising Relocatable Object Modules 
(ROMs) from specified element files and/or through M:BI. 
It may also load library load modules from the file :BLIB in 
any specified account and also the :BTM account. The 
Loader will load one or more object modules that have been 
assembled by BTM Symbol, BTM FORTRAN IV- H, standard 
Symbol (off-line), standard Meta-Symbol (off-line), SDS 
FORTRAN IV (off-line), or FORTRAN IV-H (off-line). It 
will not build overlay structures, and always loads modules 
as protection type 00 (regardless of the type specified). 

To enter the Loader subsystem, the following command is 
used: 

[LOAD 

LOADER OPTIONS 

When the Loader subsystem is entered, it responds first with 
a request for the names of all element files from which the 
user wishes to load. If no element files are named, the 
Loader will assume input is through M:BI. (The default 
assignment of M:BI is the file BOTEMPa.) 

ELEMENT FILES : 

Upon typing the request for element files (above), the 
Loader expects a user to list his element file names with a 
comma separating the names and a carriage return termi- 
nating the list. 

filename[(account,pass)],filename[(account,pass)]. . .,© 

The total number of characters in "file name", "(account, 
pass.)", and ", " may not exceed 100. 

Each file name consists of 1-11 alphanumeric characters 
and may optionally be followed by the account number and 
password in parentheses. If the user has assigned M:BI to his 
file of object modules or if he is using the default assignment 
of M:BI, then his element file list is just a carriage return. 
Any time prior to typing the carriage return, a user may 
enter ©X to erase the entire element file list. 

Example: 

]ASSIGN_M:BI, (FILE, MINE) © 

[LOAD 

ELEMENT FILES : © 

In the above example, M:BI was assigned to the user file 
MINE and was the only element file needed during loading. 

Example: 

[LOAD 

ELEMENT FILES: MINE, OURS, HIS (ACCT4) © 



This example shows the user of several different element 
files during load. The files MINE and OURS are both in 
the user's account, but the file HIS is in account ACCT4. 

Upon accepting the element file list, the Loader issues a 
request for options: 

OPTIONS : 

This request expects an option list consisting of the following 
options separated by commas and terminated by a carriage 
return. 

option [,option] . . . [,option] © 

Any time prior to typing the carriage return, a user may 
enter © X to erase the entire option list. 



Options 



N 



M 



U(a 1 ,a 2 ,. 



' a „> 



Description 



No system library search will be made 
for unsatisfied primary references. 
Unless this option is specified the 
:BLIB file in the BTM system account 
(: BTM) will be searched for unsatisfied 
primary references. 

A load map t of all DEFs and REFs will 
be output through M:LO when loading 
is completed. If this option is not 
specified, only SREFs (secondary ref- 
erences) and PREFs (primary references) 
will be output through M:DO (and 
M:LO if it is assigned to a different 
file). 

Unsatisfied references should cause a 
search of the : BLIB fi I e in each of the 
accounts specified before the optional 
search of :BLIB in the BTM system 
(:BTM) account. If this option is not 
specified, no search of nonsysfem ac- 
counts will be made to satisfy primary 
references. 

When option P is specified, all pro- 
grams defined by separate modules 
will be started on the next highest 
X'100 1 word boundary. The starting 
bias for a program is X'200 1 in the 
on-line memory area. 

Specifying the P option simplifies the 
task of relating assembly listings to 
memory locations while debugging. If 
should be noted however that separate 
control sections within each module 
will be contiguous and will not be 
started on any particular boundary, 
other than doubleword. 



See sample load map at the end of this chapter. 
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Opfions 


Description 


D 


Option D provides for execution of 
programs under control of a debug 
program, and is primarily of use in 
checking out assembly language pro- 
grams; however, it may be put in con- 
trol, with no ill effect, during the 
execution of any program that can be 
run using the LOAD subsystem. 



When the option list has been accepted, the loader loads 
the specified ROMs. If any errors are encountered during 
loading, an error message is output through M:DO (and 
M:LO if if is assigned to a different file). The following 
section, "Loader Error Messages", describes each message 
in detail. For any unsatisfied REFs to DCBs (F:alpha, 
where alpha is a name consisting of 1 to 8 alphanumeric 
characters), the DCBs will be built by the Loader and 
the default assignment will be to the user terminal. 

The Loader will also request that the user specify any DCBs 
he will need for which there are no REFs or for which to 
change the assignment. (Any FORTRAN unit numbers 
aside from 101, 102, 103, 104, 105, 106, 108 fall into 
this category. See "FORTRAN IV-H Subsystem" for de- 
tails.) The request is of the form: 

Fj [nj =name [(account, pass)] [,option] . . . [,optionl 



nmmots rhfi DCR rlf»<;rrintinn 



IN specifies the file is only to be 

used for input. 

OUT specifies the file is only to be 
used for output. 

INOUT specifies the file is to be used 
in an update mode. 

OUTIN specifies the file is to be used 
as a scratch file. This is the default 
option. 

2. The release option is 

REL 

which specifies the file is to be released at 
the end of this execution (the default option 
is that it will be saved). 

3. The listing file option. This specifies that 
the file will eventually be listed on a listing 
device. The option is 



Note: When assigning an input disc file, it is important 
that the IN option be given. The default assign- 
ment in all Sigma loaders is OUTIN, meaning a 
scratch file. Attempting to read before writing 
will cause the Monitor to create a new file of the 



n is the unit number (for FORTRAN users) or an 
alphanumeric name (up to eight characters). 

=name indicates the name of the file to which the 

DCB is assigned. If a carriage return has been 
given right after "n", the Loader would have 
assumed the DCB was assigned to the users 
terminal. 

(account, pass) specifies the account and password 

in which the file "name" (above) exists if it is not 
in this user's account. 

options: there are three possible types of options 

that may be requested aside from the file name 
(the file name must be the first item mentioned 
after the " = ", but these options may be in any 
order following the file name): 

1. The function option may be any of the 
following: 



IN 



Example: 

F © 

The user does not wish to have any DCBs assigned to files. 
This is also the way a user ends his DCB requests (see next 
example). 

Example: 

R5© 

F:6 = MINE © 

R7 = YOURS (BTM1),IN© 

F: © 

The user wanted F:5 assigned to his terminal and F:6 assigned 
to the scratch file MINE, which is to be saved at the end of 
the job. F:7 is assigned to an input file, YOURS, in ac- 
count BTM1. The fj ©ends the list of assignments. 

When the load has been completed, the Loader will 
issue a message denoting the highest error severity level 
encountered. 



OUT 

INOUT 

OUTIN 



SEV. LEV. = n 
where 

n is a hexadecimal digit. 
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Then the Loader requests the user to specify whether or not 
the load module just formed should be executed: 



XEQ? 

where 

Yor © 



N | © 
S,adrJ 



means yes, execute the load module. 



N means no, do not execute the load module and 

exit to the Executive. 

S means yes, execute the load module and use the 

following address (adr) as a start address for 
execution. 

adr is either an external definition (optionally fol- 
lowed by a hexadecimal addend value) or a signed 
absolute hexadecimal address. 

The first digit in the absolute hexadecimal constant must 
be a "." (e.g., S,.1AC). 

Example: 

SEV. LEV. =0 

XEQ? Y© 

In this example, there were no load errors and the user re- 
quested execution of his program. 

Example: 

SEV. LEV. = 3 

XEQ? S,MYPROG +. A3 © 

This load module has a severity level of 3, but the user 
wishes to execute it anyway. A start address of MYPROG 
+ A3j£ is given. MYPROG is an external definition (i.e., 
appears in a DEF statement in a Symbol or Meta-Symbol 
program or is a subroutine or function name in a FORTRAN 
program). 

Example: 

SEV. LEV. = C 

XEQ? N 



There were serious errors encountered (in the above example) 
and the user decided not to try to execute his load module. 

EXECUTION 

When a user program is in execution, the Load subsystem 
monitors the process and will respond to any errors, such as 
a nonexistent instruction, with an appropriate message. 

Should the terminal user key in © , the Load subsystem 
is put back in control and it will inquire 

PROCEED? 



If the user responds with 

Y 

execution will continue. Any other response causes the 
Executive to be put in control. 

Keying in the ©©command twice while a user program is 
in execution will cause the Executive to be put directly in 
control. Should the Executive PROCEED command be given, 
the Load subsystem will still inquire as above, whether 
user-program-level execution is to continue. 

LOADER ERROR MESSAGES 

If a user specifies a nonexistent option in his option list 
(see "Loader Options" above) the Loader issues the 
message : 

ILLEGAL OPTION 

and regenerates a request for options. 

During the load process, any errors are output through M:DO 
(and M:LO if it is assigned to a different file). The form 
of the error messages is as follows: 

error statement 1 (any message in Table 2) 

error statement 2 (any set of comments in Table 3) 



Table 2. Loader Error Messages 


Message 


Description 


NO LIB FILE 


The specified library could 




not be found. 


NO ELEMENT FILE 


The requested element file 




could not be found. 


ILLEGAL ORIGIN 


An attempt was made to 




load outside the available 




area. 


ILLEGAL ROM DATA 


The ROM contained illegal 




object language. 


CHECKSUM ERROR 


There was a checksum error 




in the specified record. 


SEQUENCE ERROR 


The sequence of the record 




following the specified one 




was not equal to the current 




sequence plus one, and the 




current record is not the last 




record in a ROM, or the first 




record in a ROM is missing. 


STACK OVERFLOW 


There is not sufficient room 




in memory for the Loader, 




the program, and the loader 




stacks. 
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Table 3. Loader Error Comments 



LOAD MAP EXAMPLE 



Comment 


Description 


PROCESSING LIBRARY 
account SEQ. NO. xx 
OVERALL ROM NO. yy 


The error document in error 
statement 1 (see Table 2) 
occurred after the Loader 
had processed all the ROMs 
contained in the specified 
element files. This error 
was encountered in the 
"account" named in line 2 
of this comment. It occurred 
in record "xx" of the "yy"th 
ROM encountered in this en- 
tire load operation ("xx" 
and "yy" are hexadecimal 
numbers). 


LOADING FROM BI 
SEQ. NO. xx 
OVERALL ROM NO. yy 


The loader was processing 
ROMs through M:BI when the 
error occurred in the "xx"th 
record of the "yy"th ROM 
("xx" and "yy" are hexa- 
decimal numbers). 


LOADING ELEMENT FILE 
name SEQ. NO. xx 
OVERALL ROM NO. yy 


The loader was processing 
ROMs from the file, "name", 
and the error occurred in the 
record sequenced "xx" in the 
"yy"th ROM encountered in 
entire load operation ("xx" 
and "yy" are hexadecimal 
numbers). 



type 

(see below) 



Example: 

ILLEGAL ORIGIN 
LOADING FROM BI 
SEQ. NO. 1A 
OVERALL ROM NO. 1A 



Example: 

SEQUENCE ERROR 
PROCESSING LIBRARY 
MY ACCT SEQ. NO. 4E 
OVERALL ROM NO. 31 



Example: 

CHECKSUM ERROR 
LOADING ELEMENT FILE 
MINE SEQ. NO. 1C 
OVERALL ROM N0.2B 



I 

PREF 

PREF 

PREF 

PREF 

PREF 

PREF 

SREF 

UDEF 

UDEF 

UDEF 

UDEF 

UDEF 

UDEF 

UDEF 

UDEF 

UDEF 

UDEF 

UDEF 

UDEF 

UDEF 

UDEF 

UDEF 

DEF 

DEF 

DEF 

DEF 

DEF 

DEF 

DEF 

DEF 

DEF 

UDEF 

UDEF 

UDEF 

UDEF 

UDEF 

DEF 

UDEF 

UDEF 

UDEF 

UDEF 

UDEF 

DEF 

DEF 

DEF 

DEF 

DEF 

DEF 

DEF 

DEF 



label of DEFs or 
REFs 



9DATAN2 

8MSGBUF 

8TALPHA 

8ABORTEX 

8ABRTSEV 

8TERROR 

BF:BUFF 

2800 LOWEST LOC— lowest 

2864 ATAN location for 

2864 ATANF user program 

2868 COS 

2868 COSF 

286C ALOG10 

2870 SQRT 

2870 SQRTF 

2874 ALOG 

2878 EXP 

2878 EXPF 

287C SIN 

287C SINF 

2880 TANH 

2880 TANHF 

2884 BF:SET1I 

2886 BF.-SET1R 

2898 BF:SET1C 

289A BF:SETDC 

289C0 BF:SET1D 

28B6 BF-.SET2D 

28B8 BF:SET2I 

28BA BF:SET2R 

28D6 BF:SDIAG 

3559 7ERRINIT 

355C 7BUFOUTC 

355E 7BUFOUT 

357F BF:RUNIO 

3582 DCBSETUP 

3660 BF:TYPE 

3668 BF:KEYIN 

3673 BF:SE 

3680 BF:ST 

368D BF:SB 

36E4 HIGHEST LOC — highest lo- 

3BD0 M:DO~ 

3BA0 M:LL 

3B70 M:OC 

3B40 F:101 

3B10 F:102 

3AE0 F:103 

3AB0 F:104 

3A80 F:105 

lAzn n c. mx 



DEF 3A20 F:108^ 



cation for 
user program 



DCBs for user program 



-first byte (within word) 
of DEF 



word address of DEF 
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Loader Error Messages 



where "type" is: 

SREF (Secondary REFerence.) The label specified 
on this line was referenced only as a secondary 
reference (see Symbol and Meta-Symbol manual 
90 09 52). 

PREF (Primary REFerence.) The label specified was 

a primary reference, but no corresponding definition 
was made for that label. 

DEF (External DEF inition.) The label has been both 

defined and referenced. 

UDEF (Unused DEF inition) The label has been 
defined but not referenced. 

DDEF (Double DEF inition) The label has been 

encountered more than once during loading. The 
first definition is used. 

UNDEFINED SYMBOLS IN LOAD MAP 

When the D option has been specified, the load map will 
also include undefined internal symbols for each element 
file included in the loading process. For example: 



ILOAD 

ELEMENT FILES: BOl, B02 

OPTIONS: D, P 

PREF ALPHA 

PREF BETA 

**UNDEFINED INTERNALS** 

* EF- BOl 

USYM GAMMA 
USYM DELTA 

* EF - B02 

USYM ZAP 
F: 



► only with 'D 1 option 



The undefined-symbol map will always directly follow the 
normal map produced by the Loader. Undefined internal 
symbols can be detected only for those object modules as- 
sembled on-line by Symbol, or in the background by Meta- 
Symbol, with the SD option. 

The loader also builds tables of internal symbols for those 
modules containing symbolic debugging information. "In- 
ternal symbols" are those symbols in an assembly that are 
not made external through use of the DEF/REF directives, 
nor defined under control of a LOCAL directive. That is, 
they are the "global" symbols of the particular assembly. 

An internal symbol table is built for each element file in- 
cluded in the load process, for later use by the debug pro- 
gram and to provide values for undefined symbols displayed 
in the load map. Only seven characters of any symbol are 



retained, along with its value and type/resolution codes. 
Should symbols in the element file have duplicate initial 
characters and length, the first such symbol encountered 
will be retained. The same name length restriction applies 
to element file names; therefore, they should be restricted 
to seven characters when creating the binary input. 

SATISFYING UNDEFINED SYMBOLS 

After any DCB assignments have been made and the severity 
level printed, the user will be requested to satisfy undefined 
symbols. 

If any PREFs were detected, the Loader will prompt with 
**SATISFY EXTERNALS** 

<_ 

The user may respond by typing the name of a PREF and its 
satisfying value, after which he will receive another "<" 
prompt. The PREF name being satisfied is terminated with 
the character ">". For example: 

<PREF>value 

where 

"value" is an expression of the form 

DEF name 

DEF name ± hex. constant 

hex. constant (identified by a leading ".") 

The following error messages are possible: 

-NAME ERROR (Improper external name.) 

-CONSTANT ERROR (Error in hex. constant.) 
-VALUE ERROR (Error occurred in value field.) 

At any time the user may enter a carriage return only, sig- 
nifying that no further PREFs are to be satisfied. When this 
is done, the Loader will place Delta in control —unless there 
were undefined internal symbols. In the latter case, the 
subsystem prompts with 

**SATISY INTERNALS** 
* EF - BOl 



The user may respond with a value for any of the symbols listed 
as undefined for this element file. A carriage return alone 
causes the Loader to go to the next element file until all 
those that contain undefined symbols have been processed. 

When satisfying internal symbol values, the user may also 
mention an existing internal symbol in the concerned ele- 
ment file. The only time this will be prohibited is when 
the combined size of the Loader, the loaded program, the 
internal symbol tables, and the DEF/REF stack exceeds the 
size of the on-line memory area; when this is the case, it 
will be noted by a console message. 
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EXECUTION AND SYSTEM INTERFACE UNDER 
THE "D" OPTION 



\a/i - t.i i~_j:„„ «,„^.^oo :, ~~~.~l«4.~ 



»-U~ H«U« J^U. 



gram is put in control and it will prompt input with the con- 
sole bell. A* this point, the user's program is completely 
initialized and ready to start execution. The ;G command 
with no expression will start the program at its normal entry; 
however, any of the debugging commands may be used to 
alter the program, insert break points or start execution at 
any location. 

The user will find this an excellent point at which to break 
to Executive level and execute the SAVE command. This wil I 
provide the ability to restart the program from scratch with- 
out having to go through a rather lengthy loading process. 

When the Loader has completed its task, the user's program 
is set up for execution in the following manner: 

The first page of memory is used for system functions. It 
contains 

1. The user's TCB (Task Control Block). 

2. System storage for registers, breakpoint control, and 
error messages. 

3. The user's temp stack (containing 156 words). 

4. A pre-al located patch area of 256 words. 





base page 
of on-line 
memory 



511 



registers 



breakpoint control 



system storage 



TCB 



TSTACK 



PATCH AREA 



16 words 
16 words 
32 words 

36 words 
156 words 

256 words 



A special symbol, %P, is built into Delta to give the base of 
the patch area. It may be displayed by the debug command 

%P = .C100 

The user's program is loaded starting at X'200' of the on- 
line memory area and continues to an even page boundary. 
If the P option was specified, individual ROMs will be 
loaded on X'100' word boundaries. Beyond the user pro- 
gram, the loader reserves two pages of memory into which 
it builds the DCB name table and any M: and F: DCBs the 
user may require. The last word of this area is associated 
with the symbol %H, in the debug program. 

The entire range of the program is considered to be program 
data, and accordingly will be swapped in and out during 
execution. 

A self-contained program, i.e., one that does not require 
any memory cells external to itself, will have little necessity 
for interface with the BTM Executive. 



On entry, register zero contains the TCB address and the 
user may push and pull indirectly through this address to 
make use of the pre-allocated temp stack (156 words). 

It is possible to do disc file I/O using the standard BPM 
CALls for the OPEN/CLOSE, READ/WRITE, and positioning 
functions. The only other functions normally required would 
be the Teletype I/O and exit CALs for use under BTM. 

With these, the program can 

1. Read characters (CAI_3,0) from the console. 

2. Write characters (CAL3, 1) to the console. 

3. Set activation class (CAL3,2). 

4. Exit to the Executive (CAL3,6). 

The following example is a simple program to write a mes- 
sage to the user console and exit. 

! BTM SYSTEM IS UP 
2/1/69 12:02 
! LOGIN :NAME,85066 
STABS 8,16 



IEDIT 






*BUILD TEXT 






1.000 


DEF AA,ENTRY,TE 


2.000 AA 


EQU 


5 


3.000 TEXT 


TEXTC 


'HELLC 


4.000 ENTRY 


LI,1 


1 


5.000 


LB, 2 


TEXT 


6.000 


LB,0 


TEXT, 1 


-i r\r\r\ 


/-AI11 


r\ 


/.VA/U 


\-fi\-o, i 


U 


8.000 


AI,1 


1 


9.000 


BDR,2 


$-3 


10.000 


CAL3,6 





11.000 


END 


ENTRY 


*END 






.'ASSIGN M.-SI, (FILE, TEXT) 




i SYMBOL 






OPTIONS: BO 






** END OF ASSEMBLY ** 




1LOAD 






ELEMENT FILES: 






OPTIONS: P, M, D 






UDEF 5 AA 






UDEF C200 TEXT 




UDEF C200 LOWEST LOC 




UDEF C202 ENTRY 




UDEF C20A0 HIGHEST LOC 




DEF C7D00 M:DO 
F: 





SEV. LEV. = 

** NO UNDEFINED INTERNALS** 

;G 

HELLO! 

XIT AT ENTRY + .6 



These CALs are described in "Teletype Operations", 
Chapter 4. 
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Programs that musf build rabies external to themselves have 
a slightly more difficult time, because the burden of noti- 
fying the Monitor about a change of program size rests with 
the user. 

Initially, the swap size of the program is set to include the 
base page, the program pages, and the Loader-built DCB 
pages. Additional space will always be available in the 
on-line memory area, however, an attempt to use it with- 
out expanding the swap size would almost certainly be 
doomed to fail. 

It is possible for the program to obtain the maximum number 
of pages available (CAL3, 14)', and then set the swap size 
to this value (CAL3, 14) . However, this is poor practice 
since if may produce an unnecessarily large amount of swap 
I/O and should be done only when complex data structures 
require it. 

In the ideal case, the program requiring additional data 
storage will start building its tables extending upward in 
memory from the DCB pages, expanding its swap size by a 
page at a time as necessary. The format of the CAL3, 13 
also allows a separate data area at the high end of core 
memory. When building expanding fables in this manner, 
the user must ensure that the data handling subroutines de- 
tect the necessity for expansion of swap size prior to inser- 
tion of data. If is possible (although not likely) that the 
program could be swapped out between the insertion of data 
into an inactive page and a subsequently given CAL3, 13. 

The following computations will be of interest for programs 
of the above type: 

1. On entry, RO contains the TCB address in the base page. 
The start of the on-line memory area can be obtained 
as: START = TCB address and X'OOOIFEOO'. 

2. If the CAL3, 13 is given with RO negative, the Monitor 
returns, in RO and Rl, the byte pattern currently 
describing the program structure (see Appendix D). 
The following instruction sequence thus obtains the 
page count of the program (since it starts as all program 
data). 

LI,0 -1 

CAL3,13 
STW,0 PD 

3. The first available data address of the first inactive 
page is then equal to 

START + (PD**9) =D1 

4. CAL3, 14 returns in register zero the maximum number 
of pages (MP). The highest available address is then 

START + (MP**9) -1 =TOP 

From these basic values, a program can perform all necessary 
computations for use with the memory management CALs. 



These CALs are discussed under "BTM System CALs", below. 



DEBUGGING 

Delta is specificallydesigned for the debugging of programs 
at the assembly- language and machine-language level. It 
operates on object programs and the tables of internal and 
global symbols accompanying them, but does not demand 
that the tables be at hand. With or without symbol fables, 
if recognizes machine instruction mnemonics and can as- 
semble, on an instruction-by-instruction basis, machine 
language programs. Its main purpose, however, is to 
facilitate the activities of debugging. These are 

1. The examination, insertion and modification of elements 
of programs: instructions, numeric values, encoded 
information, etc. 

2. Control of execution, including the insertion of break- 
points into a program. 

3. Tracing execution by displaying information at des- 
ignated breakpoints. 

4. Searching programs and data for specific values. 

To assist in the first activity, the assemblers will include 
in a program's table of symbols information about what type 
of data each symbol represents: symbolic instructions, deci- 
mal integers, floating-point values, single and double pre- 
cision values, EBCDIC encoded information, and others. 

The following summary lists the Del fa commands and facilities 
in eleven broad groupings. Delta commands are discussed 
briefly in "Delta Commands", below, and in greater detail 
under "Command Descriptions". 

1. Evaluation of expressions consisting of symbols, constants, 
special symbols, and the operators plus and minus (+-). 

2. Commands for printing the contents of memory cells and 
opening them in preparation for change. 

3. Format codes that enable the user to control the output 
format used in the evaluation and display commands of 
groups 1 and 2 above. 

4. Commands for storing new contents in open memory 
cells. 

5. Format codes that control the conversion of input con- 
stants typed by the user. 

6. Special symbols used to examine machine flags and to 
control operating bounds for Delta. 

7. Commands to insert into, delete from, change com- 
pletely, and otherwise control the symbol tables used 
by Delta. 

8. Commands to initiate and continue execution. 

9. Commands to insert, delete, and control breakpoints. 

10. Commands for searching memory. 

11. Miscellaneous commands. 
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In outlining the commands, the following conventions are 
used in depicting the format of the orders typed by the user: 



1. 



3. 

4. 
5. 



Special characters numbers, and upper case letters 
stand for themselves. Thus, in the command "e;G" 
the user actually types the semicolon and the G. 

Lower case letters are placed where the user has a 
choice of things to type. The letter e alone or post- 
scripted is used to stand for any expression consisting 
of symbols, special symbols, constants, and the oper- 
ators plus and minus (+-). At times, other lower case 
letters are used to stand for expressions when some ad- 
ditional mnemonic content seems desirable. 

Examples are n, loc, val, m. 

The letter f stands for one of the format characters. 

Abbreviations for user key strokes are: 



Letters used in text 

© 
© 
t 

\ 

© 



User Keystroke 

© 

© 

SHIFT and N 
SHIFT and L 
CTRL and I 



Most of the Delta commands are terminated (and thus de- 
livered to Delta from the resident COC handler) by the 
carriage return © character; however, certain other 
characters also delimit commands to allow dialog within 
a single typed line. The command terminating characters 
of Delta are <R, ©, t , ©, \ , and =. 



DELTA COMMANDS 

EXPRESSION EVALUATION 

e = Evaluates and types the vaiue of the expression e 

in the most appropriate format. 

e(f = Evaluates and types the value of e in format f 

(see format codes listed below). 

DISPLAYING AND OPENING MEMORY CELLS 

e/ Displays the contents of a cell e in the most ap- 

propriate format. The cell is opened; that is, it 
may now be changed. 

e(f/ Displays the contents of cell e in format f. 

el,e2/ Displays the contents of cells el through e2 in 
el,e2(f/ the most appropriate format or in the specified 
format. Cell e2 is opened. 

e Opens, but does not display, ceii e. 

/ A slash alone, following a display, displays but 

does not open the cell addressed by the display. 
(Displays the cell addressed by the last quantity 
typed (;Q)). 

© Tab alone, following a display, displays and opens 

the cell addressed by the display. 



STORING IN OPEN MEMORY CELLS 

e @ Stores the word specified by e in the currently 

QrjS" '"oil nnr) r-lncoc mo foil 
wp,^,., ^,„,. ^.,._ „.„_ — ..._ __.„. 

e © Stores e in the currently open cell, closes it, and 

opens and displays the next higher addressed cell. 

e Stores e in the currently open cell, closes it, and 

opens and displays the next lower addressed cell. 

e © Displays and opens the cell addressed by the last 

quantity typed (;Q). If an expression precedes 
the © it is stored in the previously open cell. 

FORMAT CODES FOR / AND = COMMANDS 

F Symbol table format type 

X Hexadecimal word 

I Signed decimal integer 

C EBCDIC characters 

R Symbolic instructions with symbolic addresses 

A Symbolic instructions with hexadecimal addresses 

D Double word decimal integer 

S Short floating-point number 

L Long floating-point number 

(f;/ Sets the default format for / commands to f 

(f;= Sets the default format for = commands to f 

INPUT CONVERSIONS AND EXPRESSIONS 

Expressions for evaluation, display, and storage are formed 
from the program symbols, explicit constants, and special 
symbols using the operators plus and minus (+-). 

The conversions that maybe specified for explicit constants 
are: 1) hexadecimal when introduced by a period (e.g., 
.BAD), 2) EBCDIC characters when surrounded by single 
quotes (e.g., 'BAD'), and 3) decimal when the constant c 
consists only of numerics (e.g., 1234). 

SPECIAL SYMBOLS 

Special symbols are recognized by Delta and may by used in 
expressions. Used as commands, they set the value of the 
corresponding symbol table entry. 



Last opened cell address 
Instruction counter 
Condition code 
Floating Controls 
Search mask. 
Lower search bound 
Upper search bound 
Last quantity typed. 



As set by the last 
► entry to Delta or 
changed by the user 
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Delta Commands 



SYMBOL TABLE CONTROL 



MEMORY SEARCHING 



s;S 
e(f<s> 

s(fl 

s;K 
;K 



e;G 
e;X 
n;P 



e,n;I 



e,n, loc(F;B 
e, n, I oc; B 
e, , loc;B 
e,,loc(F;B 



Select" internal table s. 

The symbol s is assigned value e and 
format f. 

The symbol s is assigned the value of the 
currently open cell ($) and format code f. 

Symbol s is removed from the symbol table. 

Remove all global symbols except in- 
struction mnemonics. 



EXECUTION CONTROL 

Begin execution at e. 
Execute the instruction e. 
Proceed with execution n times. 



BREAKPOINTS 

Set the n instruction breakpoint at 
location e. 

Set the next available breakpoint at 
location e. 



Same as above but display contents of loc 
when the break occurs. Display is in de- 
fault format or that specified. 



5,n,loc;BT 1 
5,n,loc(F;BT J 



n;B 
0;B 

;B 
;P 

n;P 
;T 



Same as above but proceed from the break 
after printing (trace mode). Display is in 
format given by (F, or default format. 

Remove the n™ instruction breakpoint. 

Remove all instruction breakpoints. 

Display all active instruction breakpoints. 

Proceed from the break. 

Proceed and do not break until the break- 
point has been passed n times. 

Proceed automatically from the break after 
printing (set trace mode). 

Break at the current execution point (anal- 
ogous to the machine's RUN-IDLE switch). 



Output produced when a breakpoint is reached is 
n;B>loc 

where 

n is the breakpoint number, 

loc is its location. 

If a display is specified, the output produced is 
n;B>loc addr/contents 



Memory between the bounds specified in ;1 and ,2 (initially 
set to the lower and upper limits of the user's program) is 
searched under the mask in ;M (initially all ones). 

e;W Search for and display words that match e 

under the mask ;M. 

e;N Search for and display words that do not 

match e. 

e;l Set the memory search lower bound to e. 

e;2 Set the memory search upper bound to e. 

el,e2;L Set ;1 to el and ;2 to e2. 

e;M Set the search mask to e. 

MISCELLANEOUS COMMANDS 

;R Display locations of displayed cells as sym- 

bol plus relative hexadecimal offset. 

;A Display locations as hexadecimal numbers. 

el,e2;Z Zeros memory from el through e2. 



SYNTAX DESCRIPTION 



The language of Delta follows the formula of simplified 
expressions and single (or a few) letter commands, which 
minimizes the number of keystrokes required. Because 
every keystroke counts, and users can find most errors 
easily by eye, only a few error conditions are explicitly 
commented. The most common commands have been as- 
signed to lower case keys in order to simplify typing. 

COMMAND DELIMITERS 

In order to interface efficiently with the time-sharing system, 
Delta has been made "message" oriented. That is, only 
certain characters are recognized as command line de- 
limiters (end-of-message characters) and cause the COC 
handler to deliver the command line to Delta for inter- 
pretation. The characters used as command line delimiters 
are: 



/ 

® 

© 

i 
© 



The open and display command. 

The expression evaluation command. 

The store command and delimiter of other 
commands. 

The store and open next command. 

The store and open previous command 

The store and open indirect command 



With the exception of / and =, the commands above cause 
a carriage return and line feed. The slash (/) and equal (=) 
commands interact within a single typed line. 
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More than one command can be input on a command line. 
The command delimiter within a command line is the space 
character. For example: 

TAG1;B TAG5,,.15 ;BT 
SYMBOLS 

The symbols used by Delta for reference to memory locations, 
computing values, and formatted displays are those supplied 
from the assembly of the program plus any added from the 
terminal by the user. They are carried in Delta's symbol 
table as seven characters plus count. Symbols longer than 
seven characters are truncated to include only the first 
seven, although the count of characters is retained. Thus, 
symbols that were originally longer than seven characters 
are indistinguishable from each other; only the last received 
definition is retained. 

The symbols used by Delta follow the same rules as those for 
Symbol and Meta-Symbol — they are made up of the alpha- 
betic characters A-Z, the numerics 0-9, and the specials 
$, @, 8 , :, , ; the first of which must be nonnumeric, and 
the number of characters must be less than 8. 

Symbols have an associated type code which allows Delta 
to use a conversion for display that matches the symbols 
original use. Symbols have either a constant value or are 
associated with a memory location. If the latter is the case, 
then the type code describes the contents of the location. 
Symbol types are: 

1. Instruction. 

2. Integer. 

3. EBCDIC Text. 

4. Short floating-point number. 

5. Long floating-point number. 

6. Hexadecimal. 

SPECIAL SYMBOLS 

The initial contents of the symbol fable include the mnemonic 
names of machine instructions and a list of special symbols 
associated with program debugging. The special symbols may 
be used in expressions for values. The special symbols and 
values associated are given as follows: 



Symbol 

;2 



Vali 



Symbol 
$or . 

;I 

;C 

;F 

;M 
;1 



Vali 



Memory location of the last opened cell. 

Instruction counter contents at program 
interrupt. 

Condition code contents at program 
interrupt. 

Floating control contents at program 
interrupt. 

The mask used in memory searches. 

The lower bound used in memory searches. 



The upper bound used in memory searches. 

tu_ i — j. j.:*.. 4... 1 l, rt_u_ ~- t-U« 

value stored by the user with the commands 

© , © , and © . 



The following values are initialized in the debug program 
on entry from the loader: 



Symbol 

;l 
;2 

;I 

%P 
%H 



Vali 



Lowest user program location — excluding 
base page used for TCB, TSTACK and 
system storage. 

Highest program location. This corresponds 
to the last cell of the page containing 
Loader- built DCBs. 

Start address of the user program. 

First location of the patch area. 

Address of first word of the next page 
above the Loader-built DCBs. 



Except for "$", ". ", and ";Q", the value of these symbols 
table entries can be set by using a special command form in 
which a defining expression is given followed by the special 
symbol to be set and a carriage return: 

.C46B;I Set ;I to hex.C46B 

.FFF;M Set ;Mtohex.FFF 

The value of all special symbols may be displayed using the 
= command. 

C=4 

I=.C3BD 

F = 2 

The symbols $ and . always have the location of the last 
opened cell as their common value. The shorthand is con- 
venient in the same way as in symbolic assembly code. 

A/ LW,4 K45 $(X= C105 $/ LW,4 K45 

The ;Q shorthand for the last thing typed is similarly con- 
venient in special situations: 



ALPHA/AL5 
./AI,5 9 



;Q + 2 



INPUT OF EXPLICIT CONSTANTS 

When the user wishes to type in numbers, he must speci- 
fy the conversion that he wishes made on his input. Three 
conversion types are provided by Delta; hexadecimal, ob- 
tained by introducing the constant with a period (.); 
EBCDIC, obtained by enclosing the characters in single 
quotes ('); and decimal, the conversion used on strings 
of numerals. EBCDIC character strings follow the same 
rules as symbols used by Delta except that the maximum 
length is four characters. 
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Some examples of input constants in various formats are; 

.ACE 100 .100 14 .A 

'EBCD' 'A' 

Note that the single quote (') is required to terminate the 
EBCDIC text string, and that the string must consist of no 
more than four characters. If fewer than four, they are 
right-justified and zero filled. 

EXPRESSIONS 

Expressions are typed by the user to represent a location 
value, parameter value, or a value to be assembled into a 
machine instruction. Expressions are composed of symbols, 
explicit constants, and the operators plus ( + ), minus (-), 
and space ( ). Multiplication, division, and other opera- 
tions are not allowed and, in fact, the characters usually 
used to indicate them are used for other things — the asterisk 
to indicate addressing in instructions and the slash as the 
command for display. 

The user should have little trouble constructing legitimate 
and correct expressions for the values he wishes, as can be 
seen from the examples below: 



A+3 




A + 3-B 




AI,1 2 




STW,7 


*LOC 


LW,7 


FAB, 5 


CAL1,3 


LIST 



The space character, in addition to its use to introduce the ad- 
dress field in expressions to be assembled into instructions, is 
also used to mean plus (+). This convention is convenient for 
typing, as a space does not require the case shift that a plus 
does. Thus, some equivalent expressions and commands are: 

A 3 and A+3 

LW,5 ALPHA + 3 and LW,5 ALPHA 3 

COMMAND DESCRIPTION 

MEMORY LOCATION DISPLAY: THE / COMMAND 

The / character is a command to Delta to open a memory 
cell and display its contents. The cell is indicated by an 
expression preceding the / character. The expression is 
evaluated and the word address portion is used as a memory 
address. If no format is given and the default is F (the nor- 
mal case), then the symbol table is searched to find a sym- 
bol at the next smaller location than the indicated address, 
and the data type associated with the symbol found is used 
to control output formatting. The following are examples 
of printout that might result from various slash commands: 



100/ 



.34 



Al/ 


BAL,6 ALPHA 


A+l/ 


STW,5 BETA 


BETA/ 


ABCD 



The user may either temporarily or permanently override 
this output format control by the symbol table code. Tem- 
porary change is accomplished by indicating the desired 
format in the command. The expression for the location is 
followed by a left parenthesis character, then by one of the 
format codes (see "Output Format Control" below for a 
complete list), and finally by the slash (/) command. 



X(X/ 



.CI hexadecimal conversion 



X(C/ A 



EBCDIC character conversion 



X(I/ 



193 decimal integer conversion 



Permanent change in output format is achieved by the com- 
mand "(f;/ 11 where f is the desired format code. 



X/ 
(C;/ 



.CI 



X/ 



If a slash is typed without preceding typing by the user, the 
cell addressed by the last item printed by the computer is 
examined but not opened. This allows the user to look 
at the indirect contents of a cell. In the example below, 
ALPHA remains the open cell even though the contents of 
cell DCT8 are displayed. 

ALPHA/ LW,5 DCT8 / .32 

A cell may be opened without displaying its contents, by the 
use of the \ command. (\ is produced by pressing SHIFT and 
L keys together). This mode is convenient when the user 
wishes to insert new contents in memory and is not interested 
in the current contents. Delta remembers the mode of 
opening for cells and on ©and f commands opens rnem in 
the remembered mode. 

ALPHA \ BAL,4 SUB © 

ALPHA + . 1 \ STW,5 DCT2 © 

ALPHA + .2 \ AI,6 . 100 © 

More than one cell may be displayed using a single /com- 
mand. Two expressions separated by a comma define the 
limits of display. They are the word address of the lower 
limit followed by that of the upper limit. Following dis- 
play of the upper limit cell, it is open for change. 

ALPHA,ALPHA + 2/ BAL,4 SUB 

ALPHA + . 1/ STW,5 DCT2 

ALPHA +.2/ AI,6 .100 

Format codes may be specified with "(" as in the basic "/" 
command. 

100,101 (X/ .58000100 

101/ .68000200 
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EXPRESSION EVALUATION: THE = COMMAND 

Expressions consisting of program symbols, explicit con- 
stants,- special symbols, and the operators plus and minus 
(+-) may be evaluated by use of the = command. The 
expression may be that just typed by the user or the last 
one typed by Delta. 

2 + 2 =.4 

5 + 5 = i A 

ALPHA/ BAL,5 SUB = .6A5006B3 

5 + 5 = 2 A_ 

5 + 5 (I = 10 

The user can set the default format type by using the com- 
mand "(f;=, " where f is the desired format type. The initial 
default format is X for hexadecimal. 



MEMORY MODIFICATION: THE ©,©, f, 
AND © COMMANDS 

Four commands allow the user to store a value into a memory 
location — the one opened by a /, \ , or one of the modi- 
fication commands ©, | # or®. If no expression preceded 
the command character, the action taken is as described 
except that nothing is stored in the open cell. 



e © 



The expression e is assembled and stored in the 
open memory cell. Carriage return and new line 
codes are sent to the user terminal and display 
modes are reset to default values. 



A/ 
A/ 



BAL,4 JWS BAL,4 



GEB© 



BAL,4 GEB © 
JED/ EXU LS (X/ .68000643 / ,78C © 
./ EXU LS 

Note in the preceding that a temporary display format was 
established by the "(X/" which carried over until the 
command reset it. 



The action is exactly the same as for e ©except 
that the cell within the next lower location value 
is opened. 



EM + 4/ 
EM + .3/ 



.0 



AL3 



JHt 
1® 



e © 



The © command causes the typed expression to be 
stored in a currently open cell. Following output 
of a carriage return, the cell addressed by the 
most recently closed cell is opened and displayed. 
The effect is like that of a ©command followed 
by a ;Q/. The ©command is useful for patches: 



A/ BAL,5 


SUB© 




A+.l/ STW,6 


BETA 


B PATCH © 


PATCH/ 


AL6 


1 © 


PATCH + .l/ 





STW,6 BETA© 


PATCH + .2/ 





B A + 2 © 



OUTPUT FORMAT CONTROL 

Displays of the contents of memory locations via the / com- 
mand and expression evaluation via the = command have 
their output format controlled by codes given with the / or 
= command or by the default format as set using the (f;/ 
and (f;= commands. The original default setting of the out- 
put conversion format is hexadecimal (X) for = commands and 
under control of the nearest symbol table type (F) for / com- 
mands. Temporary conversion type settings set by using e(f/ 
or e(f = are retained until the next ©command is given. In 
particular, the temporary conversion type is retained over 
successive ©, f , /, —, and ©commands. 



(I;/ 




A(X/ 


X© 


A+.l/ 


.D© 



A +.2/ 



.E © 



A+3/ 



15 



e© When the user terminates an expression with the 

© command, the value of the expression is stored 
in the currently open cell, that cell is closed, a 
new line is produced at the terminal, and the cell 
with the next higher location value is opened. The 
mode of the initial cell opening is preserved and 
carried forward on succeeding openings as is the 
display format. 



a a/ 


435 


435 © 


A+.l/ 


763 © 




A +.2/ 


7689 © 




EM\ 


STM,4 


ERS© 


EM+.1\ 


BAL,6 


LP © 


EM+.2\ 


BGE 


BB © 



The codes that provide for directing output formatting and 
conversion are given below. In all conversions, leading 
zeros in the printout are suppressed. 

X The word (contents of memory or expression) is 

typed out as a hexadecimal number. Hexadecimal 
numbers are always typed with a leading period 
(.). X (hexadecimal) is the original default code 
for = commands. 

F Conversion is according to the format code given 

in the symbol table for the location displayed 
or that for the next lower valued location sym- 
bol if no symbol occurs at the location in ques- 
tion. For = commands, F conversion is equivalent 
to X conversion. F conversion is the default code 
for / commands. 
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I The word is converted as a signed decimal integer. 

C The word is converted to EBCDIC characters; that 

is, it is sent to the terminal directly. Non- 
printing characters may be output in this way, 
including the EOT (04) character, which will 
turn off some types of terminals. 

R The word is converted to a symbolic instruction. 

Output has the form OP, R, ADDR, X (similar to 
assembler symbolic machine instruction format). 
OP is the symbol table value of the operation code 
part of the word (bits 0-7) - %XX is printed if 
the operation code value (XX) of the word is not 
an instruction. R is the value of the register field 
(bits 8-1 1) and (if nonzero) is printed as a deci- 
mal integer. If zero, if is suppressed aiong with 
the preceding comma. ADDR, the address field, is 
printed with a leading "*" if bit is a 1 and is 
followed by the symbol obtained from lookup of 
value in bits 15-31. If no symbol corresponds to 
the value, then the next lower location symbol 
plus a relative hexadecimal offset is printed. 
Values less than the base address of the on-line 
memory area are always printed in hexadecimal. 

If the index field (bits 12-14) is nonzero, if is 
printed as a decimal integer (1-7), following 
the address and a comma. If OP, R, and X are 
zero, only the address is printed. 

A The word is converted in exactly the same way 

as for R format, except that the address field is 
always given as a hexadecimal number. 

S Short floating-point number. The word is con- 

verted from internal floating-point format to the 
form XXXXX E±YY. 

L Long floating-point number. Same as s except 

the current word plus the next highest addressed 
word are converted (same as S for = command). 

D Double word decimal integer. The current word 

plus the next word are converted as a 64-bit 
decimal integer with sign (same as I for = 
command). 

EXECUTION CONTROL: THE ;G, ;P AND ;X COMMANDS 

The three commands described in this section allow the 
user to begin and continue execution of his program. Each 
of the commands is terminated by a carriage return (or a 
space, if it is in a multi-command line). Execution is 
started by typing "e;G" where e is an expression for the 
starting location. (The value of the expression is masked 
to form a word address.) 

BEGIN;G 

Execution can be stopped in any of three ways: 

1. Encountering a breakpoint. 

2. A user interruption via the ©key (depressed twice). 

3. An error causing a machine trap (illegal instruction, 
memory protect violation, etc). 



In each case, the cause of the stop is reported by an appro- 
priate message, the values of ;I, ;C, and ;F are set, and 
terminal control returns to the user. 

BRK AT .C5C3 

PRIVIL INSTR AT .C77B 

;I= .C77B 

The user may proceed from a stop condition caused by error 
or manual intervention, by typing the ;P or the ;G command 
without a preceding address expression. The effect is to 
continue execution from the iocafion specified by the cur- 
rent value of ;I (i.e., where execution left off, or a loca- 
tion specified by the user). The use of ;P for instruction 
breakpoints is covered in the next section. For user inter- 
ruptions via the ©key, execution continues as if the inter- 
ruption had not occurred. 

BRKAT .C68C 



;P 



Proceeding from a machine trap will, in general, cause re- 
execution of the violating instruction and another trap. 

MEM PROTECT FAULT AT .C74B 



;G 



MEM PROTECT FAULT AT .C74B 

(In either of the above cases any expression typed before 
the ;P is ignored.) The ;X command assembles and executes 
the expression just preceding the ;X. 



LH,3 
STB,6 



TABLE + 4;X 
*LOC;X 



If the expression does not result in a legitimate instruction, 
the illegal instruction message results }ust as if the error 
had been in an executing program. If the expression is a 
branch, instruction control goes to the user's program (or 
causes a memory violation). Thus, the commands "B GO;X" 
and "GO;G" are equivalent. If the expression is a sub- 
routine jump, the subroutine is entered and if it returns 
normally (to the calling location plus 1,2, or 3), CPU con- 
trol returns to Delta and terminal control is returned to the 
user. If the return is to other than the calling location 
plus 1,2, or 3, the results are unpredictable. 

BREAKPOINTS: THE ;B COMMAND 

Delta provides the user with eight separate breakpoints on 
instruction execution. As each breakpoint is reached, a 
small amount of information is printed out, giving the break 
location and an associated value. A special mode allows 
execution to continue automatically after the breakpoint 
report to provide a limited kind of trace of the flow of 
execution control. 
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Instruction Breakpoints 

e,n;B The n breakpoint (there are eight, numbered 

i_ o\ :_ ._*. «._ _i — >.: — i 4...— _„„j._^I 

I O/ 13 SCI IU 3IU|J CACk-UIIUII UIIU ICIUIII bUllliUI 

of the terminal to the user when the instruction 
at location e is reached. If n is not specified, 
Delta will assign the next available break num- 
ber. If none are available, Delta produces the 
message "NONE". The user may then release 
one of the breakpoints he has set and try again. 
The breakpoint stop occurs before execution of 
the instruction at e. When the breakpoint is 
reached, Delta prints the number and type of 
breakpoint and its location. 

A+3,1;B A;G 

l;B>A+.3 

A third field of the breakpoint command may be used to 
specify a location to be displayed when the breakpoint is 
reached. Registers as well as core locations can be dis- 
played in this way: 

A+3,1,R5;B A;G 

l;B>A+,3 5/ .54 

A particular display format other than the default can be 
specified by giving the break command in the format e, n, 
loc (f;B. 

If the execution has stopped at a breakpoint, the user may 
examine and modify his program as appropriate and then 
continue from the point of interruption by giving the com- 
mand ;P. A count may be given with the ;P command. If 
the count is n, the breakpoint will be passed n times before 
the break occurs. Execution can also be continued by the 
:G command; however, the proceed count cannot be input 
with the ;G. 

PH + 8,2,R2(I;B PH;G 

1;B>PH + 8 R2/ 4 ;P or ;G 

1;B>PH + 8 R2/ 5 ;P or ;G 

l;B>PH + 8 R2/ 6 5;P 

1;B>PH + 8 R2/ 11 

The breakpoint is an interruption logically prior to execution 
of the instruction. A break at a particular location followed 
by immediate modification of the break location will cause 
the modified contents of the break location to be executed 
when the ;P is given. This is true even if the active break 
is released before or after the modification of the break 
location. 

The n'" 1 breakpoint may be removed by the command n;B. 
All breakpoints can be removed by the command 0;B. 
If the user wishes to trace a particular instruction, he may 
give either of the forms above (display or no display) and 



specify the T mode: e,n,loc(F;BT. In this mode, when the 
instruction at e is reached, the breakpoint reporting informa- 
tion is printed and execution continues. 



A+3,4,5(I;BT 


A;G 


4;B>A+3 


5/' 


54 


4;B>A+3 


5/ 


-1 


4;B>A+3 


5/ 


-175 



The trace mode can be set after a break occurs by spec- 
ifying ;T. 

The currently valid instruction breakpoints may be listed for 
inspection with the command ;B. The list has the form 

n^Tfloc display 

for each established breakpoint, where: "n" is the breakpoint 
number, a "T" is printed if the trace mode is set for that 
breakpoint, "loc" is the break location, and "display" is 
the address to be displayed when the break occurs. 

MEMORY SEARCHING: THE ;W AND ;N COMMANDS 

The two active search commands, "e;W" and "e;N", 
search memory for a match or no match with expression e. 
Display of all matching cells (bit for bit identically) occurs 
in the case of ;Wand of all nonmatching cells in the case 
of ;N. The search is carried out in the closed interval de- 
fined by the symbol table values of ;1 and ;2. The initial 
vaiue of ; 1 is rne lowest, and ;2 trie nignest current user 
data area address. Before the test for a match is made, the 
word from memory is masked with a word that is the symbol 
table value of ;M. The initial value of ;M is all ones. 

The values of ;1, ;2, and ;M are set by the commands e; 1, 
e;2, and e;M (each followed by®). In addition, the limits 
may be set with the single command el, e2;L which sets ;1 
to el and ;2 to e2. 



A;l 
BB;2 

2;M 

2;W 



A,BB;L is equivalent 

Mask bit 30 of the words between A and BB 
which have a 1 in bit 30, 



A + .2/ 


2 


A+.3/ 


3 


A +.6/ 


6 


A +.7/ 


7 


A + .A/ 


.A 


BB/ 


.B 



.1FFFF;M L,L+.100;L ERR;W 
L + .3/ BAL,4 ERR 



L+.A/ 


BAL,4 


ERR 


L+.D/ 


BAL,4 


ERR 


L + .6A/ 


AWM,1 


ERR 



All words between L 
and L+.100 with ad- 
dress equal to ERR. 
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SYMBOL TABLE CONTROL: 
THE ;K ;S ! AND <> COMMANDS 

The symbol table available to Delta after a load is completed 
consists of the global symbols (those defined by DEF directives) 
and a set of internal symbol tables (one for each element file 
loaded) which are stored under the element file name. 

During debugging, the user always has the global symbols 
of the load and he may select one of the internal symbol 
fables by using the s;S command. If replaces, for reference 
purposes, any previously selected infernal symbol set. 

. B73/ LW,4 IOP+.A7 © 

IOP + .CB/ BAL,6 IO + .17F IOPF;S f 

IOPT2 + .6/ LW,4 K34 

Symbols may be defined by the user at any time during his 
debugging session. Symbols so defined are added to the set 
of globai symbols associated with the program load. 

s;S Select the internal symbol table corresponding 

to EF name "s". 

s(f ! Adds the symbol s to the global symbol fable with 

the location value of the currently open cell 
($ or .) and format type f. If f is omitted, sym- 
bolic instruction (R) type is assumed. 

e(f<s> Adds the symbol s to the global symbol table, 
with the value defined by the expression e and 
format code f. In addition to the normal codes, 
the letter K may be used to indicate constant 
value. If f is omitted, R is assumed. 

s;K Removes the symbol s from the symbol table. The 

removal is permanent if s is in the global table 
and temporary if s is in an internal symbol fable. 
(It will return if the user switches to another in- 
ternal symbol table and back again.) 

;K Is used to remove all symbols from the symbol 

table. Symbols defining instruction codes are 
not erased. Individual internal symbol tables 
are recoverable using an s;S command. 

MISCELLANEOUS COMMANDS: 
THE ;A ;R AND ;Z COMMANDS 

The commands discussed in this section cause Delta to change 
its normal or default modes for display and to clear specified 
areas of memory. All commands in this section are termi- 
nated by a carriage return. 

The commands ;R and ;A are complementary to one another; 
they control how Delta displays location values when typing 
the contents of cells. The mode of display is either relative 
(;R) or absolute (;A). When in the relative mode, Delta 
looks up the location value in the symbol table and displays 
the symbol if one corresponds to the value; if not, it displays 
the symbol with next smaller value and a word offset in 



hexadecimal. The form value;R may be used to specify a 
maximum offset "value" that may be displayed in the rela- 
tive mode. Offsets in excess of this will cause the display 
to revert to the absolute mode. If the mode is absolute (;A), 
then all location values are displayed as hexadecimal num- 
bers. Note that these commands control the display of loca- 
tion values and not the display of the address parts of instruc- 
tions contained in those locations. 

;R Display Example: 

A,A + 5/ LI, 1 .10 



A + .l/ 


CW,1 


K45 


A +.2/ 


BGE 


ZZZ 


A + .3/ 


AI,1 


1 


A +.4/ 


B 


A17 


ZZZ/ 


STW,2 


BR13 



;A Display Example: 

A, A + 5/ LI,1 .10 

.5CD/ CW,1 K45 



.5CE/ 


BGE 


ZZZ 


.5CF/ 


AL1 


1 


.5D0/ 


B 


A17 


.5D1/ 


STW,2 


BR13 



The command for zeroing memory takes the form 

a,b;Z 
where 

a is the lower limit 

b is the upper limit of memory to be zeroed. Ex- 

pressions may be used for a and b. An error re- 
sults if the value of b is less than that of a, or if 
the range does not lie within the on-line memory 
area. 

Example: 

A,A+5;Z 

100, 1;Z 

11 

The last line of this example is a syntax error message re- 
ferring to the previous command. The upper limit was less 
than the lower limit and the error was discovered when 
Delta processed the seventh character in the command line 
(see "syntax errors" in the following section). 
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ERRORS AND ERROR MESSAGES 

Errors resulting in machine traps are reported explicitly to 
j.l_ i _^_„„i^ _^_». i :_ „i. „j j.„ uj~. *^ _.,,_:*. £.... 

mo uoci uiiu ^/uiijuic v-urnivji 10 iciuiiicu iu hum iw unun iui — 

ther commands. Each message is accompanied by the loca- 
tion (symbolic if possible) of the offending instruction. The 
messages are: 

NONEXIST INSTR AT 

NONEXIST MEM REF AT 

PRIVIL INSTR AT 

MEM PROTECT FAULT AT 

I/O ERR AT 

UNIMP INSTR AT 

FIXED ARITH OVFLW AT 

FLOAT FAULT AT 

DECIMAL FAULT AT 

BAD CAL AT 

Syntax errors are reported by the message "? n". Where 
n is the number of characters in the command line that 
Delta was processing when the error occurred. This mes- 
sage is sent to the user whenever Delta cannot understand 
the user's command syntax. It is usually simpler for the 
user to identify the error than for Delta to be specific about 
it. Some errors and the reasons for them are shown below: 

(Too many commas) 

(Constant value larger than 
one word) 



X,Y,Z,2,7/ 


? 


8 


'ABCDE* = 


? 


6 


ABC;K 
? 5 






FF;M 100,XY;L 


,6B;W 


? 13 






A,5;E 
? 5 






LW*5 ALPHA= 


? 


3 


.3ACR/ 


? 


5 


(B;/ 


? 


2 


;T 
? 2 







r (Symbol not in symbol table) 

(Symbol value not found. 
Remainder of command 
string ignored.) 



ommand unknown) 



(Asterisk misplaced) 

(Illegal character in hexa- 
decimal number) 

(Illegal format character) 

1 (No break in effect on 
J which to set trace mode) 



INDEX TO DELTA COMMANDS 

/ Open cell, print contents 

\ Open cell, no print 

® Store in currently open cell 



Page 
47 

47 

48 



Page 

© Store in currently open cell, open next cell 48 

| Store in currently open cell, open previous 48 
cell 

© Store in currently open cell, open cell last 48 
named 

= Evaluate and print expression 48 

<...> Define symbol 51 

! Define symbol 51 

;1 Set lower limit 50 

;2 Set upper limit 50 

;/ Set default display conversion mode 47 

;= Set default display conversion mode 48 

;A Display location values as hexadecimal 51 

;B Set (or clear instruction breakpoint; BT set 49 
trace mode; display break table. 

;C Set condition code 46 

;F Set floating controls 46 

;G Begin execution 49 

;I Set instruction counter 46 

;K Remove (kill) symbol table entry 51 

;L Set upper and lower limits for search 50 

;M Set the search mask 50 

;N Search for word mismatch 50 

;P Proceed from breakpoint 49 

;Q Last quantity typed 46 

;R Display location values as symbol plus 51 
hexadecimal offset 

;S Select internal symbol table 51 

;T Set trace mode 50 

;W Search for word match 50 

;X Execution instruction 49 

;Z Zero Memory 51 
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11. SYMBOL SUBSYSTEM 



The BTM Symbol assembler is an extended version of SDS 
Sigma 5/7 Symbol, described in the Symbol/Meta-Symbol 
Reference Manual (90 09 52). The assembler accepts 
source images through M:SI and creates binary and listing 
files through M:BO and M:LO. 

Default assignments for these files are: 



M:SI 

M:LO 

M:BO 



User's console 
User's console 
File BOTEMPa 



The Executive command for entering the SYMBOL Sub- 
system is: 

! SYMBOL 



The assembler then requests options. 

OPTIONS: 

The user should then enter a list of options selected from 
the following set. 



Options 


Purpose 


BO 


Write binary output through M:BO. 


LO 


Write listing output through M:LO. 


CN 


Include cross-reference listing in LO. 


SD 


Include on-line debug symbol tables 




in BO. 



The following example shows a Symbol assembly with list- 
ing output to a disc file, and binary output to the default 
file, BOTEMPa 

IAS SIGN M :LO, (FILE, CMPLO) 

IAS SIGN M .-SI, (FILE, CMPS) 

[SY MBOL 

OPTIONS: BO, LO, CN 

**END OF ASSEMBLY** 

The default assignment for the assembly listing is the user 
terminal. The listing is reformatted in this instance due 
to the width of the console carriage. Each source line pro- 
duces two listing lines: 

1. The source image. 

2. The line number and the object code portion of the 
normal listing. 

If the source input file is sequenced according to EDIT con- 
ventions, the sequence number will also be displayed in 
decimal format on the second line. 

If the assembly listing is not being displayed on the console, 
any errors found in the assembly are displayed on both the 
console and the listing file. The console display is in the 



IUI ill Ul 



A carriage return alone requests all of the above options. 
If any individual options are stated, only those are used. 



1. The offending source line. 

2. The normal Symbol error indicator, positioned under 
the image. 

3. The line number, object code produced, and sequence 
number of the record (if it had one). 
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12. SUPERVISORY SUBSYSTEM (SUPER) 



SUPER is available as a batch processor and as an on-line 
subsystem. It provides the capability to add or delete legal 
users, list aH legal users, and to obtain the passwords for 
all files Tn a specified account. SUPER can only be ac- 
cessed while running with account :BTM. 

The commands to SUPER are described below. Records con- 
taining commands must begin in column 1 . Some of the com- 
mand records can be followed by records specifying con- 
cerned-accounts or users. Records specifying users begin in 
column 2 and each group of records is terminated by an 
EOD. These records have the general format: 

y bname,acct, pass, disc 

Name,acct, and pass have the same meaning as in LOGIN; 
disc is a hexadecimal number specifying the maximum disc 
space that may be used (in granules). Functions that do not 
require pass or disc parameters may omit them. SUPER reads 
the control device (Teletype if on-line) and outputs to 
M:LO. The batch version lists all of the input records. 

SUPER COMMANDS 

U[SERSJ (Authorize on-line users) 

The specification records that follow cause the indicated 
"name,acct,pass" combinations to be added to the account- 
ing log. Should such a user already be in the log, the fact 
is noted and the specification record is ignored. If a password 
is not specified at this time, it will not be required for log-in. 

K|JLLUSERSj (Cancel on-line access) 

All users mentioned on subsequent specification records are 
removed from the accounting log and will thus be denied 
access to the system. If a summary of the user's statistics is 
desired, it should be requested prior to the command remov- 
ing his entry from the accounting log. 

S[TATSJ (Summarize accounting totals) 

The pass and disc options are not meaningful on this com- 
mand. Specification records should be of one of the follow- 
ing formats: 

/ 6name,acct 

"b^accf 



The first form summarizes the statistics for the individual 
user, while the second form summarizes the statistics for 
all users in the account. These summaries are output to the 
M:LO device. 



Should the STATS command not be followed by any speci- 
fication records, the entire accounting log will be summar- 
ized by account. 



D[ELSTATS] (Initialize statistics) 

For all account or name-account specifications following, 
the statistics are cleared to zero, with the exception of 
maximum disc space and disc space used. 

L[lST] [acct] (List users) 

This command does not require subsequent specification 
records. If the LIST command specifies an account, all 
users outhorized under that account are summarized. If 
the LIST command does not specify an account, the pro- 
gram summarizes all users authorized for access to the 
system. 



PfASSWORDSlncct fFil 



e summary 



This command requires no specification records. On en- 
countering this command, the processor will list all file 
names, with their passwords, that are in the specified ac- 
count. This capability allows the installation super- 
visor to remove entries in the file management system. 
If a file has no password, ***NONE*** is listed. If the 
password cannot be represented by printable graphics, it is 
listed in hexadecimal format. Synonymous files are 
ignored. 

!EOD (End job) 

Processing terminates when an !EOD record is encountered 
while the program is expecting a control record. 
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APPENDIX A. BPM SYSTEM CALs 



Programs executing at subsystem and user levels may do RAD or console I/O through use of standard CAL1 operations as des- 
cribed in the BPM Reference Manual (90 09 54). The following table summarizes the CALs available to BTM users. 



Call 


FPT Code 


Function 


Comments 


CAL1,1 


X'OT 


M:REW 


Allowed 




X'02' 


M:WEOF 


Ignored 




X'03' 


MrCVOL 


Ignored 




X'04' 


MrDEVICE (PAGE) 


Ignored 




X'05' 


M:DEVICE (VFC) f 


Allowed 




X'06' 


M:SETDCB 


Allowed 




X'OB' 


M:DEVICE (DRC) 


Ignored 




X'OC' 


M:RELREC 


Allowed 




X'OD' 


MrDELREC 


Allowed 




X'OF' 


M-.TFILE 


Allowed 




X'10' 


M:READ f 


Allowed (wait is implied) 




X'lT 


M:WRITE f 


Allowed (wait is implied) 




X'12' 


M:TRUNC 


Allowed 




X'14' 


M:OPEN 


Allowed. The ASSIGN image, if given, overrides 
any DCB options. Parameters from the FPT, in 
turn, override these. Only four files may be open 
at one time. 




X'15' 


MrCLOSE 


Allowed 




X'lC 


M:PFIL 


Allowed 




X'lD' 


M:PRECORD 


Allowed 




X'20' 


MrDEVICE (LINES) 


Ignored 




X'21' 


MrDEVICE (FORM) 


Ignored 




X'22' 


MrDEVICE (SIZE) 


Allowed 




X'23' 


MrDEVICE (DATA) 


Ignored 




X'24 1 


MrDEVICE (COUNT) 


Ignored 




X'25' 


MrDEVICE (SPACE) 


Ignored 




X'26' 


MrDEVICE (HEADER) 


Ignored 




X'27' 


MrDEVICE (SEQ) 


Ignored 




X'28' 


MrDEVICE (TAB) 


Ignored 




X'29 1 


MrCHECK 


Allowed 




X'2A' 


MrDEVICE (LINES) 


Ignored 




X'2B' 


MrDEVICE (CORRES) 


Allowed 


CAL1,2 






Illegal 


CAL1,3 






Illegal 


CAI.1,4 






Illegal 


CAL1,5 






Illegal 


CAL1,8 


X'14' 


M-.TRAP 


Allowed 


CAL1,9 5 




MrTRTN 


Allowed 


CAL1,9 1-3 




Exit to Executive 


Allowed 


Available on c 


onsole I/O. 







ERROR CODES FROM FILE OPERATIONS 

All error codes applicable to BPM have their normal mean- 
ings. The following additional errors are possibler 



Code Error 

101 Invalid DCB address. 

102 Invalid FPT address. 

103 Invalid FPT operation code. 

104 Invalid address in FPT (e.g., illegal key 

buffer address). 

105 Invalid error or abnormal address. 

106 Invalid buffer address. 



107 No terminator on file parameter list. 

108 Invalid entry in variable parameter list. 

109 Invalid DCB table address. 
10A Too many files open. 

10B Invalid TCB address. 

10C Malformed DCB table. 

10D DCB address not in DCB table. 

10E Variable file parameter list too large. 

10F Improper "file" option in an Open or Close. 

110 Improper "function" option in DCB. 

1 1 1 User attempted to use more than his available 
disc space. 

1 12 Key too long. 



Appendix A 55 



APPENDIX B. SUBSYSTEM CONVENTIONS FOR TELETYPE INPUT 



There are three CALs associated with Teletype input: 

CAL3, Returns in register (in EBCDIC format) 
the next character in the Teletype input 
buffer. If there is no activation charac- 
ter in the buffer, the calling subsystem 
is dismissed until an activation charac- 
ter is typed, at which time the CAL then 
completes and the subsystem resumes nor- 
mally . 

CA CAL.3,2 Changes the activation type to the value 

contained in register 0. 

CAL3, 3 Sets the Condition Codes to xxlO if an 
activation character has been read into 
the Teletype input buffer; otherwise, it 
sets the condition codes to xxOO. 

The action of BTM on Teletype input is dependent upon 
the activation type in force and the type of character in- 
put. Tables B-l and B-2 contain a complete summary of 
these relationships. In all cases, however, should the in- 
put buffer become almost full, the bell will ring for each 
character input until the buffer is sufficiently emptied. 
Should the buffer become completely full, each charac- 
ter input will still ring the bell, but the input character 
will be lost and instead a © will be placed over the last 
character in the buffer. This character will echo as a 
"?" and will always cause activation. The bell always 
rings immediately rather than in echo sequence. 

Depressing the BREAK key causes any Teletype output in 
progress to be terminated immediately and any untyped 
output is lost. Any unprocessed input waiting in the Tele- 
type input buffer is also lost. 

The subsystem activation type specifies which class of char- 
acters wili cause activation, as follows: 

Activate on all characters. Do not echo. 

1 Activate on all characters. Echo. 

2 Activate only on punctuation, control code, © , 
or ©. Echo. 

3 Activate only on control code, ©, © I, \ , / , ~ , 
or ®. Echo. 

4 Activate only on © or © . Echo. 



The echo and type of a character (see Table B-2) specifies 
to which activation class a character belongs and whether 
it is echoable. The five basic types are: 

Nonexistent character (i.e., a character that can- 
not be typed in). 

1 Nonactivating character. 

2 Punctuation. 

3 ©1/ f, / / or =. 

4 ©or © . 

A basic type with the symbol ^ added means that the 
character is echoable; without a * added, the charac- 
ter is not echoable. 

An echo type of the form @ + j, where j is an integer, 
means that the associated character is a special control 
code known to BTM. There are nine such special codes. 

Table B-l. Conventions for Activation Types and 1 



Input 


Echo 
(if any) 


Character 
User Gets 


Notes 


Letter or digit 


Same as input 


Same as input 




* $ : @"IS 


Same as input 


Same as input 




Punctuation 


Same as input 


Same as input 




Control code 


Note 


Same as input 




© or © 


Same as input 


Same as input 




Any other 

i tt 
character 


None 


None 


Character 
is ignored 


'"Punctuation" means: !"%&'()*+,-• 
/;<=>?[ \ ] t or— . 


"Any other character" normally means only those 
characters that cannot be typed in on a standard Tele- 
type (see Appendix I). 



^"Normally" means in accordance with Tables B-l and B-2. 



''Echo type 4 is used only internally by BTM. 
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Table B- 


2. Conventions for Activation Types 2, 3, and 4 




Input 


Echo 
Type 


Function 


Erasable ? 


Echo 


User Gets 


Notes 


Letter or digit 


#+1 


- 


Yes 


Same as input 


Same as input 




# $:@* 


#+1 


- 


Yes 


Same as input 


Same as input 




Punctuation 


# + 2 


- 


Yes m 


Same as input 


Same as input 




/=t 


# + 3 


- 


Yes m 


Same as input 


Same as input 




© R 


@+ 1 


Retype 


No 


©© 


None 


Retypes from last acti- 
vation character 


© Q 


@ + 


Acknowledge 


No 


! ! 


None 


Each is returned imme- 
diately rather than in 
echo sequence 


© © 


@ + 2 


Backspace 


No 


- — 


None 




© I 


@+3 


Tab 


Yes™ 


n spaces "" 


n spaces"" 




© © 


@ + 4 


Local new line 


No 


©© 


None 




© X 


@ + 6 


Erase m 


No 


e© 


None 


Erases to last activa- 
tion character 


Any other con- 
trol character 


3 


- 


Yes w 


? or none 


Same as input 




© 


@+7 


Line feed 


No 


@® 




User gets ©for activa- 
tion types 2 and 3, © 
for activation type 4 


© 


@ + 7 


Carriage return 


No 


©© 


© 




Any other 





- 


No 


None 


None 


Character is ignored 


f " Punctuation" means: !%&'()*+, 


-.;<>?[ \ ] or — . 




Any other character" normally means or 
Appendix I). 


lly those characters that cannot be 


typed in on a standard Teletype (see 


An activation character cannot be bac 
is ignored. 


<spaced over (or erased); thus an @@ immediately after an activation character 


If no tab stop is set, a ? is echoed, 
erases one space of the tab; thus to erase 


he user will get a single space if r 
the tab completely, n backspaces 


le reads such an illegal tab. Each backspace 
must be given. 


If the activation type is 4, a ? is ecr 
ter regardless of the echo. 


loed; otherwise, there is no echo. 


The user always gets the actual input charac- 
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APPENDIX C. SUBSYSTEM CONVENTIONS FOR TELETYPE OUTPUT 



There is one CAL associated with Teletype output: Flag Meaning 



1 The corresponding USASCII character is 

printable. 



CAL3, 1 This CAL takes a character (in EBCDIC for- 
mat) from the lower 8 bits of register and 

places it into the Teletype output buffer. The code is the USASCII equivalent of the EBCDIC char- 

a ... i mi rn/TM/- i . • acter, or 0. 

Associated with every possible bBLUIC character is a 

7-bit USASCII conversion code and a 1-bit control flag. . , , , r , . n . . . . 

.. Any character whose flag is or whose conversion code is 

is ignored by CAL3, 1. A conversion code of implies 

... . , that the EBCDIC character has no corresponding USASCII 
Flag Meaning . . _ . .. . r i i- r cn/-r^i^ 
— equivalent, bee Appendix J tor a complete list ot bBLDlL- 

USASCII correspondences - any character that has a blank 
The corresponding USASCII character is entry in the "prints as" column of this table has a con- 
unprintable on a standard Teletype. version code and thus is not printed. 
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APPENDIX D. BTM SYSTEM CALs 



While in operation, a subsystem has a variety of ways in 
which it can communicate with the terminal user, the BPM 
file management system, and the resident BTM Executive. 

BTM provides for two levels of program execution. Both 
use the same memory area, so they may not run concurrently; 
however, for each terminal in the system, an area of RAD 
swap storage is allocated for each type of program. 

The first area, called subsystem storage, is used to maintain 
the current state of the particular subsystem the user has 
called, for example, EDIT, as it is time-sliced on the way 
to completion of the task. 

The second area, called user storage, is used to maintain an 
image of the terminal user's object program after it has been 
loaded by the Load subsystem, and during its execution. 
The user level is also where the BASIC subsystem compiles 
and executes BASIC programs. In both these cases, while 
the user's programs are in execution the subsystem level mon- 
itors all abnormal conditions, thus maintaining effective 
control. 

The resident Executive is aware at all times of the level 
applicable to the job being executed by any terminal. A 
program may only be started at user level by a subsystem; 
a program running at user level will always be interrupted 
and control given to the initiating subsystem on any occur- 
rence of an invalid operation, trap, etc. 

Ail of the console I/O capability set forth in the section on 
Teletype operation is available to both subsystems and user 
level programs. 

The following CAL3 calls are available at the levels indi- 
cated to perform system control and memory management 
functions. 

CAL3, 4 (Executive and Subsystems) 

This CAL fetches a subsystem in absolute format from a 
dedicated RAD area and transfers control to it. 

For Executive calls, Rl contains the subsystem name table 
index. For subsystem calls, Rl contains the test of the sub- 
system name. 

The subsystem name table and start address table are built 
at boot time when the subsystem storage area of the RAD is 
initialized. 

CAL3, 5 (Executive and Subsystems) 

This CAL starts a new (user or subsystem) process on the next 
lower level. Register must contain the first half of the PSD 
to be used when the new process is initialized; the format of 
register contents must be: 

Bits Contents 

0-3 Condition Code (CC) 

4-7 Floating Controls (FC) 

15-16 Instruction Address (IA) 



Return from the level invoked by the CAL3,5 is to the in- 
struction following the CAL3,5 (or the instruction following 
the first EXU of any chain of execute instructions resulting 
in the execution of a CAL3,5). 

CAL3,6 (Subsystem and User Level) 

This CAL performs a normal return to the next higher level 
process (same results as ©© . 

CAL3,7 (Subsystems Only) 

CAL3,7 is used to swap pages between the subsystem area of 
memory and user-level swap storage. This allows a subsys- 
tem to initialize a user-level process, or examine particular 
pages of the user level program in the event that control has 
been returned due to error. Swapping is controlled by reg- 
isters 0, 1, and 2 which must be in the following format. 



R0 



Rl 



R2 



78 


15 16 




31 


SPI 


WP 




RP 




N-l 


SSP 


MODE 



SSP 

SPI 

N 
WP 

RP 



Initial page number of subsystem area 
which is involved in the swap 

Swap consecutive pages after SSP (SPI=0) 
or swap SSP repeatedly (SPI^l). 

Number of pages to be transmitted. 

Initial page number of user swap storage 
into which page SSP of subsystem memory will 
be written. 



Initial page number of user level swap 
storage which is to be read into memory start- 
ing at page SSP. 

With the above parameters, the CAL allows one-way trans- 
mission between memory and swap area and vice versa, or 
two way transmissions between groups of pages in memory 
and on RAD. This is controlled by the MODE parameter: 



MODE 
Value 

<0 



>0 



Transmission Mode 

User level swap area to subsystem memory. 
User pages RP through RP+N-1 overwrite 
subsystem pages SSP through SSP+N-1 . 

Two way transmission. Pages SSP through 
SSP+N-1 of memory are written to pages WP 
through WP+N-1 of user level swap storage; 
then pages RP through RP+N-1 of swap stor- 
age overwrite pages SSP through SSP+N-1 of 
subsystem memory. 

Subsystem memory to user level swap storage. 
Subsystem pages SSP through SSP+N-1 over- 
write pages WP through WP+N-1 on the RAD. 
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Example 1 : 

(0) = 00030006, (1) = 0002000A, (2) = 

Write pages A. B, C of subsystem to pages 3.4.5 of user 
level swap storage, then read pages 6,7,8 of user level 
swap storage into pages A, B,C of the subsystem memory. 

Example 2: 

(0) = 01000000 (1) = 01F000F (2) = 1 

Write page F of the subsystem to pages through IF of 
user level storage (clear user memory if page F is 
cleared). 

CAL3,8 (Subsystems only) 

This CAL specifies (in register 0) to BTM the address of the 
Level 2 TCB address. 

CAL3,9 (Executive and Subsystems) 

This CAL calls the past or current program status doubleword 
(PSD) for the desired level. Whenever a process is restarted 
via CAL3,5 the old "current" value is saved as PAST and the 
new value in register is entered as current. Registers 2 
and 3 must contain the following: 



Reg . 
R2 



Contents 
Level number 



R3 Even (bit 31 =0) if past PSD is desired 

R3 Odd if current PSD is desired 

CAL3,9 returns results in registers and 1 as follows: 
Reg. Contents 

R0 CC, FC,TA (same as in CAL3,5) 

Rl Error code (see table below) 



Error Code 


Meaning 





Normal return caused by ©©or 




CAL3,6 


1 


Nonexistent instruction 


2 


Nonexistent memory address 


3 


Privileged instruction 


4 


Memory protection violation 


5 


Unimplemented instruction 


6 


Push-down stack limit reached 


7 


Fixed-point arithmetic overflow 


3 


Plrtntinn-nrvinf rniilt 


9 


Decimal arithmetic fault 


10 


Improper arguments to a call 


11 


Illegal call 


12 


Read error on RAD during transfer 



CAL3, 10 (Subsystems) 

This CAL transfers the error message associated with the 
most recent CAL1 error into words 20i Q through 37 w of sub- 
system memory. 

CAL3, 14 (Subsystem and User Level) 

If R0 is positive or zero, this CAL returns the maximum num- 
ber of pages that can be activated in user memory (and sub- 
system memory), in register 0. This enables users and sub- 
systems to allocate memory appropriately. 

CAL3, 1 1 (Subsystems) and 

CAL3, 13 (User Level Programs) 

inese two CALs have the same functions for the two levels 
of operation. They allow a subsystem or subsystem-initiated 
user level program to describe memory in such a way as to 
make swapping most efficient. 

CAL3, 14 will supply a program with the total amount of 
memory it may use. Initially, the Monitor will only swap 
in and out the actual amount of memory needed to contain 
the program. At any time the program may change its swap 
size within the maximum allowed, through use of CAL3, 11 
orCAL3. 13. 

A program describes itself inoneof the two following ways: 

a. or b. 

Low Core 

I - l-v I K 

I 



Available 
Memory 



High Core 

where 
Area 
PD> 1 
PP > 




> PD 



IN ACT 



PD 

\ PP 

DD 

IN ACT 
CDP 



Contents 

Program data pages swapped in and out. 

Pure procedure pages (unmodified during 
execution), swapped in only. 



DD^O Dynamic data pages swapped in and out. 

INACT s Inactive pages, not swapped. 

CDP 2; Common data pages, building down from 

top of available memory; swapped in and 
out. 

a. This is the simplest case and exists when a sub- 
system is started. Size may be changed by appro- 
priate CAL with PD communicated in R0. INACT 
is, by default, everything other than PD. 
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(RO) 




RO 



31 



PD 








15 16 




31 


M 


D 



(RO) 
o 



(Ri) 
o 



This case allows the most efficient description of 
the program. Page counts of the various types are 
computed, and communicated to the Monitor in 
registers and 1 as follows: 



Rl 




78 



15 16 



23 24 



31 



R2 



^o 








PD 



78 



15 16 



23 24 



31 



whc 



PP 


DD 


IN ACT 


CDP 



15 16 



31 



B 


Y 








15 16 




31 


H 


MIN 



CAL3, 15 (Subsystem and User Level) 

This CAL returns the date and time in registers 0-2 in the 
following format: 



M = month 1-12 

D = day 1-21 

B = blanks 

Y = last two digits of year 

H = hour 0-23 

MIN = minute 0-59 






Two EDCBIC digits 
each 
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APPENDIX E. SUBSYSTEM INTERFACE 



There are several simple rules that BTM expects each 
subsystem to follow. These rules apply to the way a 
subsystem is coded and the way a subsystem is loaded 
into the BTM system. 

CODING REQUIREMENTS 

The first 40., locations in any subsystem should con- 
tain the following data. 



Location 


Data Description 





Contains the word address of the first 




word of the subsystem's TCB (Task Con- 
trol Block). 


1 


=0 


8 


=0 


9 


Contains the word address of the normal 




entry point for the subsystem. The entry 
point for a "PROCEED" is assumed to be 




this address plus one. 


A 16 


=0 



Location 


Data Description 


F ,6 
,0 16 

3F 16 


=0 

Reserved for use by Monitor. 

Reserved for use by Monitor. 



When a subsystem is entered, Rl contains the COC line 
number (in binary), R4 and R5 contain the log-in account 
designation (in EBCDIC, left-justified and blank filled), 
and R2 contains the terminal job entry flag (0 indicates that 
the console is excluded from the system, and a value of 
1 - F indicates the maximum priority). 



Included with the ROMs that constitute a subsystem 
there must appear a DCB name table (see Figure E-l) 
pointed to by word 10 of the TCB (see Figure E-2), and 
all the necessary DCBs assembled with protection type 
00. 



DCBTAB 







u 






u 


N 


B , 


B 2 


B 3 


l 













n-3 



n-2 



n-1 



DCBLOC 



LINKADDR 



DCBLOC 



where 

LINKADDR 

N 

B.-B 
I n 

DCBLOC 







-i — -+■ 



14 15 16 



23 24 



31 



is the address of the location provided for storing a return address, 
indicates the number of characters in the DCB name, 
indicates the EBCDIC name of the DCB. 

is the address of the first word location of the DCB. 



Figure E-l, DCB Name Table 
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14 15 16 



31 



'here 



TSTACK 

TSS 

TSWC 

TSA 

TSASIZ 

ERTSIZ 

ERT 

DCBTAB 



10 
11 
12 
13 
14 
15 

TSA 

ERT 
TSTACK 









TSTACK 


TSS 


TSWC 


These words for use by processor 




TSA 


U 


u 


TSASIZ 


TSAWC 


ERTSIZ 


ERT 


ERTSIZ-2 


TSA+ 1 


n <"> 


DCBTAB 


u 


VJ 


These words for use by Monitor 


Library error temp stack 


Library error table 


User's temp stack 



15 16 



TSASIZ 
ERTSIZ 

TSS 



31 



s the address of the current top of the user's temp stack. 

ndicates the size, in words, of the user's temp stack. 

s the temp stack word count giving the current number of words in the user's temp stack. 

s the address of the temp stack used by the library error package. 

ndicates the size, in words, of the temp stack used by the library error package. 

ndicates the isze, in words, of the error table used by the library error package. 

s the address of the error table used by the library error package. 

s the address of a table of names and addresses of all of the user's DCBs. This table has the form 
shown in Figure E-l. 

Figure E-2. TCB Format 
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There are several CALs available (for use by a subsystem 
only) to provide service for the subsystems. These CALs 
mainly deal with changing the size of swap areas for sub- 
systems and users, finding out the amount of core currently 
being used by subsystem and user, and performing swaps be- 
tween user and subsystem memory. They are described in 
Appendix D, "BTM System CALs". 

The format for DCBs is essentially the same as described in 
the BPM Reference Manual, 90 09 54. The one difference 
is the ability to assign DCBs to a user's console. This is 
done by setting the ASN (bits 28-31) in word of a DCB 
to 5 (ASN is the file assignment type indicator — means 
null, 1 means FILE, 2 means LABEL, 3 means DEVICE, 4 
means CORE, 5 means user's console). 



LOADING REQUIREMENTS 

The ROMs that comprise the subsystem should be loaded into 
the system by running the following job under BPM. 



UOB :SYS,user,l 

! LOAD (ABS),(BIAS,loc),(NOTCB),(PERM), ; 



subsystem ROMs 



!FIN 



name is the subsystem name to which console users 

will refer. 

loc is the hexadecimal value of the base of the on- 

line memory area. 

When the system is booted from the RAD, the load module 
will be initialized in absolute swap storage as a subsystem 
callable by the first two characters of the name. 
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APPENDIX F. BTM SCHEDULING 



The BTM resident Executive is an extension of the Batch 
Processing Monitor. It is not organized as a real-time task, 
but is essentially a subroutine called by the BPM at inter- 
vals governed by one of the hardware clocks. The following 
is a short discussion of the manner in which the machine is 
shared. 

Interrupts generated by the COC are always handled by the 
BTM Executive, and it is the receipt of the initial break 
character that causes the BTM system to start accepting in- 
put from a terminal. Input characters for all terminals are 
buffered in the resident Executive, until the on-line user's 
job is able to fetch them. 

When no consoles are actively processing on-line jobs, the 
clock guarantees that the BTM Executive will be allowed to 
scan the active lines once every batch quantum to determine 
whether any user requires the services of a nonresident BTM 
function. If so, the swap-in of that processor is started and 
batch processing continues. 

After this point, and while several on-line users are sharing 
the machine, the scheduling of on-line and batch jobs is 
performed in an asynchronous manner, with the clock only 
enforcing certain maximum and minimum time intervals. 
Figure F-l illustrates this, and assumes that the swap-in of 
an on-line job has just been completed, and that several 
on-line users exist and are being serviced. 



The on-line quantum (OLQ) is a SYSGEN parameter (default 
100 ms) which specifies the maximum length that a subsystem 
may run before a batch job is serviced. The on-line task 
may not be dismissed in the middle of a RAD I/O action 
through the file management system, and therefore under 
certain circumstances may run slightly longer. Should the 
subsystem request Teletype input when none is available, it 
is dismissed immediately. An actual on-line time slice may 
vary from a minimum of 2 or 3 ms (if dismissed at once) to a 
few ms more than the specified quantum (to allow I/O to be 
completed). Receipt of the necessary Teletype input marks 
the subsystem for activation. 

At dismissal time, all I/O actions necessary to complete the 
swapout are queued up as direct access, and the batch job 
is started. (If, at the end of a user's on-line quantum, no 
other user in the system is ready for execution, the swap-out 
I/O is not started. The user's task in memory will receive 
subsequent on-line quanta, as it is able to use them, until 
another on-line user requires service. In this single- 
user case, successive batch quanta would be terminated 
by the clock.) 

The completion of of the SIOl operation triggers SIQ2. The 
swap-in I/O requests are queued up and the batch job con- 
tinues. (From the diagram, it is seen that if the swapping 
RAD and the batch file management RAD have the same 



Time 



RAD 
Swapping 



On-line 
Tasks 



File Manage 
System 
and RAD 



Background 



| 

User 1 
OLQ 



SIOl )( SIQ2 



User 2 
OLQ 



SIOl )( SIQ2 ■ 



| ^ 



Serving OL Serving BG Serving OL Serving BG 



"\r 



^r 



■\r 



BGQ 



BGQ 



I 



active 



— . inactive 



OLQ On-line quantum. 

SIOl Swap-out time for the on- 
line task being dismissed 



SI02 Swap-in time for the user 
in line for service. 

BGQ Background quantum. 



Figure F-l. On-Line Time-Sharing 
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control ler, there is a severe conflict when the batch job re- 
quires RAD I/O or Monitor overlays.) 



greatest with the Model 7204 and 7232 RADs, because of 
their lower transfer rates. 



The background quantum (BGQ) is a SYSGEN parameter 
(default 200 ms) that specifies the length of time a batch 
job may run before servicing the next on-line task. How- 
ever, it is almost always the case in practice that the back- 
ground quantum is set by the length of SIOl and SI02. 
Batch processing will never be interrupted before the swap 
is done, and with the 7204 RADs this is on the order of .8-1 
second. 

The intervals SIOl and SI02 vary greatly for each subsystem, 
depending on size and on how the subsystem has described 
itself with the memory management CALs. This variance is 



When the high-speed RAD is in the system for swapping, the 
background quantum is used as the minimum time during 
which batch jobs must run, to prevent batch jobs from being 
effectively locked out by on-line jobs with short swap and 
long execution times. 

With the high-speed RAD, it is seen that the most that can 
be done for optimizing response time is to set the SYSGEN 
value of the background quantum very low, so that the on- 
line programs run on a demand basis. In this case, batch 
jobs would utilize no more than the "busy time" of the swap- 
ping RAD. 
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APPENDIX G. BTM MACHINE OPERATION 



Machine operation with BTM is virtually identical to that 
of the standard BPM system. Perhaps the most noticeable 
difference occurs when the system is booted from disc, for 
example, to start operation after loading the disc from 
tape. 

After the normal BPM header information is typed, the 
BTM Executive must find all of the on-line processors in 
the system account and initialize them in absolute swap 
storage. This will typically take 4-5 seconds, after which 
the resident Executive types a second message: 

BTM SWAP AREA IS FROMxxxxTO END OF DISC ndd. 



xxxx is the first disc address of absolute swap area. 

ndd is the channel and device designator of the 

swapping RAD. 

It is not necessary to wait for the second message before 
initiating batch operations. Although batch jobs may be 
started immediately, consoles will not respond to the © 
© input until the second message has been typed. 

As on-line users enter the system, this will be noted on the 
operator's console by a message similar to the following: 

* CONSOLE xx LOG ON. 



xx is the hexadecimal representation of the user's 
COC line number. 

If the BTM accounting package is implemented in the sys- 
tem, the log-in message will be accompanied by the user's 
name and account number identification. 

When a user leaves the system, the fact will be noted on 
the operator's console by the message 

* CONSOLE xx LOG OFF. 



KEY-INS 

The machine operator exercises ultimate control over the 
system with the following key-ins, which are given in the 
standard BPM fashion. 

IBTMM [,xx] text 

This key-in causes the text message to be printed on all 
consoles (or console xx) without affecting their current op- 
eration. For example: 

IBTMM SYSTEM DOWN IN FIVE MINUTES. 



!BTMX[xx] 

This key-in terminates the activity of the indicated console. 
If no specification is given, all active consoles are deacti- 
vated. The message 

BTM HALTED BY OPERATOR 
time date 

is output to all consoles currently active. Background 
operations are started if not already active; this ensures 
that a quiescent state will be reached (see "System Save 
for Restart"). This key-in, when used to deactivate all 
consoles, also disables the time-sharing portion of the sys- 
tem. Attempts to activate consoles are met by the message 



BTMQ 



IBTMS 



When the system is first booted from disc, the time-sharing 
portion of the system is active. If the 1BTMX key-in has 
been used to terminate operations, they may be restarted 
with this key-in. Following the key-in, the consoles re- 
sume service, and the message 

BTM IS OPERATIONAL 

is broadcast to all consoles still connected to the system. 

TERMINAL JOB INSERTION 

When BTM is being supported by a symbiont BPM system, 
on-line users are able to insert jobs into the batch queue. 
The machine operator will be alerted, when this occurs, 
by the message 

* JOB yyy (p) FROM CONSOLE xx. 



yyy is the JOB ID, and p the priority. 
This will aid him in dispatching output. 

SYSTEM SAVE FOR RESTART 

In order to save user's files and provide a restart position, 
it is good policy to dump the file area of secondary storage 
onto tape periodically. This is also necessary whenever the 
system is to be shut down and the RAD will not be kept in- 
tact (e.g., preventive maintenance or use of another oper- 
ating system). If the system is to be shut down but RAD 
storage will be preserved, it is not necessary to perform a 
dump; the system can be initiated from secondary storage 
with the standard boot procedure. 
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Either of the above operator actions, booting from RAD or 
dumping to tape, can be done only when the entire system 
is quiescent. 

Conditions required for the system to become quiescent are: 

1. BPM must be in the "wait state". 

2. No symbiont may be active. 

3. No symbiont files can exist (input or output). 

4. All consoles must be logged off. This can be assured 
with the BTMX key-in. 

When these conditions are met, the Monitor prints the 
message 

SYSTEM IS QUIESCENT. 



Power-on/Power-off routing. This procedure does the 
following: 

1. Saves crucial nnrts of HGP ^disc allocation maol and 
ACNCFU (pointer to account directory) on disc. 

2. Stores the symbiont file directory in high memory. 

3. Simulates a disc boot. 

4. Moves the symbiont file directory from high memory 
back to its proper place. 

If symbionts were active at the time of the failure, the 
following precautions should be taken before attempting 
recovery: 



This must be the last entry on the operator's log if there 
is to be a restartable system. Dumping to tape or booting 
from disc under any other circumstances cripples the sys- 
tem. 

The portions of the system that must be saved so the system 
may be restarted are PSA (Permanent System Area) and PFA 
(Permanent File Area). Neither PER (symbiont storage) nor 
swap storage need be saved, since they are scratch areas. 

SYSTEM ERROR RECOVERY 

From the above discussion, it is obvious that in the event 
of failure (for any reason) the system may not be initiated 
irorri tne iv/^i^ via a stanuaru uoot process, L the machine 
is hung up due to an irrecoverable error in the middle of 
a job, it is impossible for the Monitor to attain quiescence. 

It is possible to recover permanent files and symbiont out- 
put for all but the jobs that were executing at the time of 
failure, using the recovery procedure provided with the 



1. Do a DISPLAY key-in. 

2. If any output files still exist for the batch job that was 
executing at the time of failure, delete them. If any 
input files were partially created by input symbionts. 
delete them by means of a DELETE key-in. 

3. Do an S key-in (see BPM Reference Manual) to process 
outstanding input files. Do not initiate input symbionts 
until these jobs are processed, as job IDs assigned by 
the system start with and conflicts may occur. 

Some disc space is lost in the recovery procedure. Per- 
manent file area for all currently open output files will be 
lost Svmbiont disc storage f r ^ r ' svmbi'^ r *^ fi'es ^'■prgntlw 
being output, and for symbiont files currently being read by 
the system will be lost. 

To initiate the recovery procedure, the operator simply 
presses SYSTEM RESET and moves the RUN-IDLE switch to 
RUN (the reset will have put the machine in the idle state). 
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APPENDIX H. TIMING 



The time required to process a single Teletype input char- 
acter is as follows: 

1. If the character can be echoed immediately, the 
processing time is 

177.0 + Q + R+ 17.5/nus) 
(min: 257.4 ps — max: 300.5 ps) 

2. If the echo must be deferred, the processing time 



219.6 + Q + R + 27.9/mps 
(min: 310. 4 ps — max: 353.5 ps) 



/-N _ (31. 8 if the buffer is empty 

143.6 if the buffer is not empty 



At the time 
of the input 
interrupt 

At the time 



J 31. 1 if the buffer is empty 1 . , 

162.4 if the buffer is not empty j . 



interrupt 



and 



n = The number of characters input simultaneously 
by all Teletypes. 

m = The number of characters input since the last 
activation character but not echoed. 
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APPENDIX I. USASCII TO EBCDIC CONVERSION 



USASCII 
Code 


Teletype 
Character 


EBCDIC 
Character 


Echo 

and 

Type 


USASCII 
Code 


Teletype 
Character 


EBCDIC 
Character 


Echo 

and 

Type 


Hex. 


Octal 


Char 


Key 2 


Hex. 


Prints 
as 


Hex. 


Octal 


Char 1 


Key 2 


Hex. 


Prints 
as^ 


00 


00 


(NUL) 


pes 


00 







IE 


36 


(RS) 


N cs 


IE 




1 


01 


01 


(SOH) 


A c 


01 






IF 


37 


(US) 


o cs 


IF 




1 


02 


02 


(STX) 


B c 


02 






20 


40 


blank 


SPACE 
BAR 


40 


blank 


#+1 


03 


03 


(ETX) 


C c 


03 






21 


41 ! 


I s 


5A 


(0 


# +2 


04 


04 


EOT 


D c 


04 






22 


42 


ii 


2 s 


7F 


(") 


# +2 


05 


05 


WRU 
(ENQ) 


E c 


09 






23 


43 


# 


3 s 


7B 


# 


#+1 


06 


06 


RU 
(ACK) 


F c 


06 






24 


44 


$ 


4 s 


5B 


$ 


#+1 


25 


45 


% 


5 s 


6C 


% 


# +2 


07 


07 


BELL 
(BEL) 


G° 


07 


bell 


# + I 


26 


46 


& 


6 s 


50 


& 


# +2 


27 


47 


■ 


7 s 


7D 


i 


# +2 


08 


10 


(BS) 


H c 


08 






28 


50 


( 


8 s 


4D 


( 


# +2 


09 


11 


TAB 
(HT) 


I C 


05 




3 


29 


51 


) 


9 s 


5D 


) 


#+2 


OA 


12 


LF 


LINE 
FEED 


25 


line 
feed 


@+7 


2A 


52 


* 


.s 


5C 


* 


# +2 


2B 


53 


+ 


_s 


4E 


+ 


#+2 


OB 


13 


VT 


K c 


OB 






2C 


54 


i 


i 


6B 


/ 


# +2 


OC 


14 


FORM 
If?)" 


L C 


OC 




@+l 


2D 


55 


- 


- 


60 


- 


*+ 2 


2E 


56 


. 


. 


4B 


. 


# +2 


OD 


15 


CR 


RETURN 


15 


carriage 
return 


@+7 


2F 


57 


/ 


/ 


61 


/ 


#+3 


OE 


16 


(SO) 


N c 


OE 






30 


60 








FO 





#+1 


OF 


17 


(SI) 


O c 


OF 






31 


61 


1 


1 


Fl 


1 


#+1 


10 


20 


(DLE) 


pC 


10 






32 


62 


2 


2 


F2 


2 


#+1 


11 


21 


(DC1) 


Q c 


11 






33 


63 


3 


3 


F3 


3 


#+1 


12 


22 


TAPE 
(DC 2) 


R c 


12 






34 


64 


4 


4 


F4 


4 


#+1 


35 


65 


5 


5 


F5 


5 


#+1 


13 


23 


X-OFF 
(DC3) 


s c 


13 






36 


66 


6 


6 


F6 


6 


#+1 


37 


67 


7 


7 


F7 


7 


#+1 


14 


24 


(DC4) 


T c - 


14 






38 


70 


8 


8 


F8 


8 


#+1 


15 


25 


(NAK) 


U c 


OA 






39 


71 


9 


9 


F9 


9 


#+1 


16 


26 


(SYN) 


V c 


16 






3A 


72 


: 


: 


7A 


: 


#+1 


17 


27 


(ETB) 


w c 


17 






3B 


73 


i 


/ 


5E 


/ 


# +2 


18 


30 


(CAN) 


x c 


18 






3C 


74 


< 


5 


4C 


< 


«+ 2 


19 


31 


(EM) 


Y c 


19 






3D 


75 


= 


_S 


7E 


= 


# +2 


1A 


32 


(SS) 


Z c 


1A 






3E 


76 


> 


S 


6E 


> 


# +2 


IB 


33 


(ESC) 


K cs 


IB 






1C 


34 


(FS) 


L cs 


IC 






3F 


77 


? 


/ s 


6F 


(?) 


#+ 2 


ID 


35 


(GS) 


M cs 


ID 






40 


100 


@ 


ps 


7C 


@ 


#+ i 
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USASCII 
Code 


Teletype 
Character 


EBCDIC 
Character 


F U 4 

Echo 

and 

Type 


USASCII 
Code 


Teletype 
Character 


EBCDIC 
Character 


Echo 

and 

Type 


Hex. 


Octal 


Charl 


Key 2 


Hex. 


Prints 
as 3 


Hex. 


Octal 


Char 1 


Key 2 


Hex. 


Prints 
as 3 


41 


101 


A 


A 


CI 


A 


#+1 


55 


125 


U 


U 


E4 


U 


#+1 


42 


102 


B 


B 


C2 


B 


#+1 


56 


126 


V 


V 


E5 


V 


#+1 


43 


103 


C 


C 


C3 


C 


#+1 


57 


127 


W 


W 


E6 


W 


#+1 


44 


104 


D 


D 


C4 


D 


#+1 


58 


130 


X 


X 


E7 


X 


#+1 


45 


105 


E 


E 


C5 


E 


#+1 


59 


131 


Y 


Y 


E8 


Y 


#+\ 


46 


106 


F 


F 


C6 


F 


#+1 


5A 


132 


Z 


Z 


E9 


Z 


#+1 


47 


107 


G 


G 


C7 


G 


#+1 


5B 


133 


(1) 


K s 


4F 


1 


# +2 


48 


no 


H 


H 


C8 


H 


#+1 


5C 


134 


N 
(\) 


L s 


4A 


00 


# +2 


49 


111 


I 


I 


C9 


I 


#+1 


4A 


112 


J 


J 


Dl 


J 


#+1 


5D 


135 




M s 


5F 


(-0 


#+2 


4B 


113 


K 


K 


D2 


K 


#+1 


4C 


114 


L 


L 


D3 


L 


#+1 


5E 


136 


t 
(-) 


N s 


6A 




#+3 


4D 


115 


M 


M 


D4 


M 


#+1 


5F 


137 


(-) 


O s 


6D 


(-) 


# +2 


4E 


116 


N 


N 


D5 


N 


#+1 


4F 


117 


O 


O 


D6 


O 


#+1 


• 


• 


• 


• 


'• 


• 





50 


120 


P 


P 


D7 


P 


#+1 


51 


121 


Q 


Q 


D8 


Q 


#+1 


: 


• 


• 


• 


' 


• 


52 


122 


R 


R 


D9 


R 


#+1 


7E 


176 


ESC 


ESCAPE 


IB 







53 


123 


S 


S 


E2 


S 


#+1 


54 


124 


T 


T 


E3 


T 


# +l 


7F 


177 


DEL 


RUBOUT 


FF 







Notes: 

1. The forms in parentheses appear only on SDS Teletype 3. The forms in parentheses are contained in the SDS 63- 

"/015, whereas the unparenthesized forms appear on and 89 -graphic character sets but not in the standard 

the specified keys of all standard model Teletypes. 57-graphic character set. On printers equipped with 

(Some models lack the ESCAPE key). The forms in only the standard character set, these forms will print 

braces print when the specified key is depressed, but as blanks. 

they do not appear on the keys. . Tl , . . .... . , . .... ... 

' ' ' ' 4. The echo and type specifies the echoabihty and acti- 

2. Superscript c indicates use of the CTRL key; super- vation type of a character. See Appendix B for a 
script s indicates use of the SHIFT key. more complete description. 


The Teletype character mnemonics have the following meanings: 

ACK Acknowledge ENQ Enquire NAK Negative acknowledge 

BEL Bell EM End of medium NUL Null 

BS Backspace EOT End of transmission RS Record separator 

CAN Cancel ESC Escape SI Shift in 

CR Carriage return ETB End of transmission block SO Shift out 

DC! Device control 1 ETX End of text SOH Start of header 

DC2 Device control 2 FF Form feed SS Start of special sequence 

DC3 Device control 3 FS File separator STX Start of text 

DC4 Device control 4 GS Group separator SYN Synchronize 

DEL Delete HT Horizontal tab US Unit separator 

DLE Data link escape LF Line feed VT Vertical tab 
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APPENDIX J. EBCDIC TO USASCII CONVERSION 



! 
EBCDIC Teletype 

Code Character 


USASCII 
Code 


EBCDIC 
Code 


Teletype 
Character 


USASCII 
Code 


Hex. 


Prints 

as^ Chan Key 2 


Hex. 


Octal 


Prints 
Hex. as ^ 


Char 1 


Key 2 


I 
Hex. Octal 


00 


(NUL) i P cs 


00 


00 


ID 


(GS) 


M cs 


ID 


35 


01 




(SOH) A c 


01 


01 


IE 


(RS) 


N cs 


IE 


36 


02 




(STX) 


B c 


02 


02 


IF 


(US) 


QCS 


IF 


37 


03 




(ETX) 


C c 


03 


03 








; 




04 




EOT 


D c 


04 


04 




LF 


LINE 
FEED 


0A 


12 


05 




TAB 
(HT) 


I c 


09 


11 


25 


line 
feed 


\ 


; 




; 


[ 


; 


06 




RU 
(ACK) 


F c 


06 


06 


40 


blank 


blank 


SPACE 
BAR 


20 


40 


07 


bell 


BELL 
(BEL) 


G c 


07 


07 




I 


\ 


" 


; 


08 




(BS) 


H c 


08 


10 


09 




WRU 
(ENQ) 


E c 


05 


05 


i 


4A ; (d 


N 
(\) 


L s 


5C 134 


OA 




(NAK) 


U c 


15 


25 


4B j . 




• 


2E 


56 


OB 




VT 


K c 


0B 


13 


4C \ < 


< 


s 


3C 


74 


OC 






OC 


14 


rv^<IMV\ l . c 

(FR L 


4D ( 


( 


8 s 


28 


50 


s ' 


4E | + 


+ 


.s 


2B 


53 


QD carriage 
return 




OD 


15 


CR 


RETURN 


4F 1 


{a 
to 


K s 


5B 


133 


OE 


(SO) 


N c 


OE 


16 




50 & 


& 


o" 


26 


46 


OF 


(SI) 


O c 


OF 


17 




: 


[ 




\ 


io I 


(DLE) 


p c 


10 


20 


11 




(DC1) 


Q C 


11 


21 


5A I (!) 


j 


1 S 


21 


41 


12 




TAPE 
(DC2) 


R C 


12 


22 


5B $ 


$ 


4 s 


24 


44 


5C 


* 


* 


.s 


2A 


52 


13 




X-OFF 
(DC 3) 


s c 


13 


23 


5D 


) 


) 


9 s 


29 


51 


14 




(DC4) 


T c 


14 


24 


5E 


/ 


/ 


/ 


3B 


73 


15 


carriage 
return 


CR 


RETURN 


OD 


15 


5F 


(">) 


H 


M s 


5D 


135 


16 




(SYN) 


v c 


16 


26 


60 


- 


- 


- 


2D 


55 


17 




(ETB) 


W c 


17 


27 


61 


/ 


/ 


/ 


2F 


57 


18 




(CAN) 


x c 


18 


30 


• 


• 


; 


; 




• 


19 




(EM) 


Y c 


19 


31 


6A 




t 
(") 


N s 


5E 


136 


1A 




(SS) 


z c 


1A 


32 


IB 




(ESC) 


K cs 


IB 


33 


6B 


/ 


/ 


r 


2C 


54 


6C 


% 


% 


5 s 


25 


45 


1C 




(FS) 


L CS 


IC 


34 
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EBCDIC 
Code 


Teletype 
Character 


USASCII 
Code 


EBCDIC 
Code 


Teletype 
Character 


USASCII 
Code 


Hex. 


Prints 
as 3 


Char 


Key 2 


Hex. 


Octal 


Hex. 


Prints 
as 


Char 1 


Key 2 


Hex. 


Octal 


6D 


(") 


{-) 


o s 


5F 


137 


D6 


O 


O 


O 


4F 


117 


6E 


> 


> 


s 


3E 


76 


D7 


P 


P 


P 


50 


120 


6F 


(?) 


? 


/ s 


3F 


77 


D8 


Q 


Q 


Q 


51 


121 


: 




m 


\ 


; 




D9 


R 


R 


R 


52 


122 


• 


; 


; 


• 


I 


; 


7k 


: 


■ 


: 


3A 


72 


7B 


§ 


# 


3 s 


23 


43 


E2 


s 


s 


s 


53 


123 


7C 


@ 


@ 


P S 


40 


100 


E3 


T 


T 


T 


54 


124,. 


7D 


i 


i 


7 s 


27 


47 


E4 


U 


U 


U 


55 


125 


7E 


= 


= 


s 


3D 


75 


E5 


V 


V 


V 


56 


126 


7F 


(") 


ii 


2 s 


22 


42 


E6 


w 


w 


w 


57 


127 




\ 


; 


\ 


; 


\ 


E7 


X 


X 


X 


58 


130 


E8 


Y 


Y 


Y 


59 


131 


CI 


A 


A 


A 


41 


101 


E9 


z 


z 


z 


5A 


132 


C2 


B 


B 


B 


42 


102 


; 


j 


; 


• 


; 




C3 


C 


C 


C 


43 


103 


C4 


D 


D 


D 


44 


104 


F0 











30 


60 


C5 


E 


E 


E 


45 


105 


Fl 


1 


1 


1 


31 


61 


C6 


F 


F 


F 


46 


106 


F2 


2 


2 


2 


32 


62 


C7 


G 


G 


G 


47 


107 


F3 


3 


3 


3 


33 


63 


C8 


H 


H 


H 


48 


110 


F4 


4 


4 


4 


34 


64 


C9 


I 


I 


I 


49 


111 


F5 


5 


5 


5 


35 


65 


; 




; 


; 


\ 


; 


F6 


6 


6 


6 


36 


66 


F7 


7 


7 


7 


37 


67 


Dl 


J 


J 


J 


4A 


112 


F8 


8 


8 


8 


38 


70 


D2 


K 


K 


K 


4B 


113 


F9 


9 


9 


9 


39 


71 


D3 


L 


L 


L 


4C 


114 


; 


[ 


; 


; 


I 


\ 


D4 


M 


M 


M 


4D 


115 


D5 


N 


N 


N 


4E 


116 


FF 




CD 


RUBOUT 


7? 


\77 



Codes X'81 1 through X'A9', which represent the lower case 
letters, are exactly congruent to X'Cl 1 through X'E9' and 
may be used interchangeably. All will print as capital let- 
ters on standard Teletypes. 

Notes: 

1 . The forms in parentheses appear only on SDS Teletype 
*7015, whereas the unparenthesized forms appear on 
the specified keys of all standard model Teletypes. 
(Some models lack the ESCAPE key.) The forms shown 



in braces print when the specified key is depressed, but 
they do not appear on the keys. 

2. Superscript c indicates use of the CTRL key; superscript 
s indicates use of the SHIFT key. 

3. The forms in parentheses are contained in the SDS 63- 
and 89-graphic-character sets but not in the standard 
57-graphic-character set. On printers equipped with 
only the standard character set, these forms will print 
as blanks. 
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APPENDIX K. BTM SYSTEM GENERATION 



GENERAL INFORMATION 

This discussion is intended only as a supplement to the 
SYSGEN documentation in the 'BPM Reference Manual, 
Chapters 10 and 11, to aid a person already familiar with 
the SYSGEN process. 

The principal change in system generation has been the 
addition of the :BTM card, and the necessity for including 



on a standard BPM BI tape the ROMs required to provide 
the BTM functions. 

The :BTM card allows the specification of system parameters 
that are installation dependent. It has the form: 

:BTM (option), (option), . . . , (option), ; 

(option), etc. 



Option 


Meaning 


Default 


Limits 


Units 


NUMUSERS,n 


Total number of time-sharing consoles that 
may be in use at one time. 


8 


1-64 


Dec. 


USERSIZE,n 


Size, in words, of the time -sharing memory 
area. The size must be a multiple of 512 
(one page). 


16384 


12288- 
65536 


Dec. 


NUMSYSTS, n 


This provides an upper limit on the number of 
subsystems that can be in the system. It is pru- 
dent to provide for more than the standard set, 
so they can be added after the system is gen- 
erated. This should also be taken into account 
when allocating swap area. 


12 


10-30 


Dec. 


BPMQTM, n 


The minimum amount of time BPM runs before 
time-sharing users are scheduled. 


200 


10-500 


ms 


BTMQTM, n 


The maximim amount of time an on-line user 
may run before BPM receives another quantum. 


200 


50-500 


ms 


IBUFSIZE,n 


COC input buffer size. The number of bytes 
that may be typed ahead before data is lost. 
This is also the maximum number of characters 
that may be typed before an activiation char- 
acter is typed. 


100 


80-200 


Dec. 


OBUFSIZE,n 


The number of characters which can be held in 
each user's COC output buffer without further 
program intervention. 


100 


80-400 


Dec. 


IINT,n 


The location of the COC input interrupt. 


60 


60-13F 


Hex. 


OINT,n 


The location of the COC output interrupt. 


61 


60-13F 


Hex. 
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The BI tape must have all the normal BPM modules plus the 
following files: 



File 


Contents (ROMs) 


BTMBO 


BTM power on/off, initialization, and 




Executive routines. 


BTM :B LIB 


On-line FORTRAN run-time and math 




library. 


BTMFLINT 


On-line FORTRAN interface program. 


BTMFORT 


On-line FORTRAN compiler (cat. no. 




704176). 


BTMLOAD 


LOAD subsystem (cat. no. 705260). 


BTMEDIT 


EDIT subsystem. 


BTMSYMB 


On-line SYMBOL (cat. no. 704158). 


BTMFER 


FERRET subsystem. 


BTMBPM 


BPM subsystem. 


BTMBASIC 


on-line BASIC. 


BTM 


SYSGEN :BTM card interpreter. 



The PASS2 processor has had the segment "BTM" added to it 
to process the :BTM system Generation control card. The 
tree of the PASS2 processor is now 

1TREE CCLOAD - PASS2CCl-MODIFY-DECBS-(DEVICE, 
SDEVICE,; 

[MONITOR, DLIMIT, RJITGEN-(RESERVE, INTSR), ; 

!CLOCK,ABS,BTM) 

SYSGEN OPERATIONAL INFORMATION 

PASS! 

The :SELECT cards should select the additional modules 
needed for the particular system being generated: 

BTMBO is required for any BTM system 

BTM:BLIB is required for FORTRAN 

BTM is required only if a PASS2 processor is to be part 
of the object system. 

Note: The BASIC subsystem requires both floating- 
point and convert instructions, and FORTRAN 
requires floating-point, so the appropriate 
simulators must be included in the absence of 
the hardware options. 



PASS 2 

:STDLB and -.DEVICE cards should be set up as in BPM except 
as discussed below. 

The last :DEVICE card specifying a DC device will be used 
as the swap device. The last part of this device will be 
used for swap storage and is not available for other alloca- 
tion. In addition, this RAD must have large enough capac- 
ity to provide all swap storage required. The amount of 
swap storage may be computed as the sum of: 

Subsystem Storage 



FORTRAN 


15 granules 


LOAD 


7 granules 


EDIT 


7 granules 


SYMBOL 


9 granules 


FERRET 


3 granules 


BPM 


3 granules 


BASIC 


17 granules 



Temporary swap area, in granules, may be computed as: 
(2*(USERSIZE/512)+4) * (NUMUSERS) 

For example, 680 granules are needed for 10 users with a 
16K on-line area. The definition of a granule is the BPM 
definition, i.e., that number of sections needed to make 
up one page (512 words). 

The user's allocation of swap area can be checked after the 
system is booted. The system types out 

BTM SWAP AREA IS FROM aaaaTO END OF DISC ndd. 

An installation desiring to add subsystems subsequent to 
SYSGEN should allow ample USERSIZE when generating the 
system. 

A card defining the communications controller address 
should be included as follows: 

:DEVICE COndd, (HAND,COC) 

:SDEVICE, :DLIMIT, :RESERVE, and :ABS cards are identi- 
cal to those used with normal BPM. 

:MONITOR card is identical. However, the following 
recommendations are made: 

TSTACK,300 for symbiont system (250 for nonsymbiont). 

SPOOL, CPOOL, MPOOL, SFIL, no change. 

CORE The correct size must be specified; the sys- 

tem cannot be patched to run on a different size 
machine. 
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QUEUE This parameter depends upon the type of 

RAD used as the swap device. 

Cat. No. 7204 - QUEUE, 80 

Cat. No. 7212 or 7232 - QUEUE, 20 

CFU If none is specified, 10 are supplied. With 

BTM, the number should be NUMUSER * 2 + 1 0. 

Note: If CFU is specified, M:CPU must precede IO 
or IOSYM on the TREE card for M:MON. 

:RESERVE should not include a RESDF specification. 

:INTS, :INTR, and :TIME should not be used. 

A :BTM card must be included to generate a BTM system. 
It generates tables that are dependent upon user area size, 
number of users, etc. It may appear anywhere after the 
•.DEVICE and :SDEVICE cards. 

The interpretation of the :BTM card produces a load module 
named M:BTM, which contains all of the variable storage 
needed by the resident Executive. The resident Executive 
(BTMBO) and M:BTM are included in the generation of the 
Monitor. 



LOAD AND OVERLAY CARDS 

M-.MON should have BTMBO and M:BTM added to the list 
of element files. These should be added to the tree speci- 
fication immediately before IORT and COOP (if included). 
The remainder of the tree structure is unchanged, except 
that the element file, PFSR should be deleted. 

BPM processor control cards are unchanged. 

BTM Subsystems. The LOAD cards for the BTM subsystems 
take the following form: 

ILOAD (MAP), (NOTCB), (PERM), (ABS), ; 

!(BIAS,bias),;bias = CORE - USERSIZE in hex. 

i(LMN,name), (EF, (ef)) 

The module name and element file entries have the follow- 
ing values for each of the subsystems: 



Subsystem LMN 



EF(s) 



FORTRAN 


FORTRAN: 


BTMFINT,BTMFORT 


LOAD 


LOAD: 


BTMLOAD 


LU1 1 


crMT. 
l.i-'i i ; 


DTunniT 

U 1 IV1I-LS1 1 


SYMBOL 


SYMBOL: 


BTMSYMB 


SUPER 


SUPER: 


BTMSUPER 


FERRET 


FERRET: 


BTMFER 


BPM 


BPM: 


BTMBPM 


BASIC 


BASIC: 


BTMBASIC 



DEF CARD 

The format of the DEF card is exactly as in BPM. If on-line 
FORTRAN is to be used, BTM:BLIB should be specified in 
the (INCL, ...) list. 



SYSTEM BOOT AND INITIALIZATION 

System boot and initialization is exactly as in BPM. The 
two initialization links are preempted for special BTM ini- 
tialization. 

USRINIT1 initializes the COC hardware, and the 

swap storage and BTM tables. 

USRINIT2 initializes the links to the power on/off 

routines, and the recovery routine. 



JOB COMMAND 

After the system has been generated, the first of the follow- 
ing two jobs must be run if on-line FORTRAN is to be used. 
The second JOB command is optional but is recommended, 
as it maximizes available disc space. 

UOB :BTM, ON LINELIB, F 1 Creates :BLIB 

IASSIGN M:BI,(FILE,BTM:BLIB,:SYS) J file under 
1LOPE (PERM,LIB) account :BTM 

UOB .-SYS, DELETE 
IASSIGN M:EI, (FILE,BTM:BLIB) 



Deletes BTM: 
BLIB in :SYS 



The :BLIB file in the :BTM account is used as the standard 
library file by the LOAD subsystem. 

CREATING SUBSYSTEMS 

All subsystems and libraries peculiar to BTM are introduced 
through use of the BPM file manage and load functions, and 
are independent of the actual SYSGEN process in the sense 
that they can be added at any time. 

The user must create a :BLIB file under the :BTM account. 

The LOAD subsystem uses the :BLIB file in the :BTM account 
as the library, although an option exists for specifying 
others. Currently, the library file contains only the on- 
line version of the FORTRAN IV-H run-time, along with 
the standard mathematical routines. 

The on-line version of the FORTRAN IV-H run-time is ob- 
tained by replacing the following routines in the standard 

-J~_l, -~4. = ..„ /.,.U:„I , — ,uu „:*i £ — RTM 

or BPM) with the BTM versions. 



Cat. No. 


Module 


704216 


BF-.SV 


704293 


BF:SC 


704294 


BF:SW 


704295 


BF:GCOMS 
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Cat. No. 



Module 



704305 


BF-.DIAG 


704306 


EXIT 


704307 


BF:SP 


704308 


BF:SO 


704309 


BF:MXXX 


704310 


BF-.TSNUM 


704334 


BF:NLOC 


704387 


BF-.RUNIO 


705293 


BF:EXIT 



A user wishing to create a library that will be used by the 
LOAD subsystem can do so by using LOPE to create a :BLIB 
file in his account. 

For example: 

"JOB ACCT,A,1 

IASSIGN M:EO,(FILE,NEWLIB) 

!FMGE (ENTER) 

ROMs 

IASSIGN M:BI,(FILE,NEWLIB) 

1 LOPE (PERM, LIB) 

IFIN 

The LOAD subsystem can then be directed to use this library 
by including the following library specification in the op- 
tion list. 

OPTIONS: A(ACCT) 

A subsystem is defined by loading it under the BPM system 
account (:SYS) and forming a load module with the name 
ending in a colon (:). For example: 

(LMN, SYMBOL:) 

The load module must conform to the interface rules laid 
down under "Subsystem Interface". 

When the BTM Monitor is booted from disc, it searches the 
system account for all load modules with this naming con- 
vention and incorporates them as on-line subsystems. 

The first two characters of the name become the Executive 
command by which the subsystem may be called, and the 
remainder of the name (exclusive of the colon) is echoed 
by the Executive. For example: 

! SYMBOL 



When the system is booted, the subsystem load modules are 
copied to a dedicated area of the RAD and referenced from 
there in absolute format. 



The Executive service routines called by the ASSIGN, 
RESTORE, SAVE, and TABS commands are part of the resi- 
dent Monitor and therefore do not have corresponding load 
modules. 

COMPONENT SIZES IN A BTM SYSTEM 

FIXED OVERHEAD 

Fixed overhead is as follows: 

BPM (BOO) 7K (Nonsymbiont) - 10K (Symbiont) 

BTM Exec. 4.5K 

VARIABLE OVERHEAD 

Tables are generated at SYSGEN time which vary with the 
number of users and subsystems. The formula for the num- 
ber of words required is: 

(NU(IB+OB)+3)/4+(9NS+8)/2+23(NU+l)+(5(5NU+12))/ 
4+(3(NS+2))/4 

where 

IB = input buffer size in characters 

OB = output buffer size in characters 

NU = number of users 

NS = number of subsystems 

Figures for three typical systems are: 

IB= 100, OB= 100, NS= 12 

NU = 8 NU= 16 NU = 24 

1K(735 words) 1.5K(1369 words) 2K(2003words) 

For safety, the numbers are rounded up to the nearest page, 
then combined with the fixed overhead figures. Therefore, 
resident requirements for an 8-user symbiont system are 17K. 

BACKGROUND AND ON-LINE AREAS 

These memory areas must be allocated from the remainder. 

on-line = USERSIZE 

background = (core size less on-line area) 

2K of context area must be allocated from the on-line area. 

Monitor blocking buffers, normally 1.5K-2K are allocated 
from the background area. 

SYSGEN DECK SETUP 

The following listings show system generation deck setups 
for two representative systems. The first deck generates a 
65K, 24-user symbiont system. The second deck generates 
a 32 K, 4-user system that permits either batch or on-line 
processing, but not both running concurrently. 
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65K SYSTEM GENERATION 



m:16#m:i7#keyin/m:i*#j 



GENDCB CHjbI/ JSYSeEN/ ( JNSN/BTMB) 

END 

J8B SSYS/MAKER88V 

ASSIGN MjEli (FILE/HJM8N) 

FMGE (DELETE) 

JBB JSYSGEN/SYSGEN 

ASSIGN M;BI,(INSN,BTMB) 

PASSl 

SELECT (FllE/R8eT/7TAP/FBCDiI8RT/HANDLERS*T8PRT/I8/j 

PRGMLDR,TYPR/I8D,DEBUG/DUMP/EXJT/M:15/ " 

m:i8#m:iajm:ib # mhom:id/Rdf*j 
8pnl,8bse#m:te,8pn,cls/mbdlfy/clsl/seglead,ldprg*memal8c#calpr8c*; 

WRTF/WRTD/DU^YcCL#LBLT/M:i9/P8S/ALTcP) 

SELECT (FILE/CRD8UT/PTAP/DFBCD) 

SELECT (FILE/I8SYM,C88P,CCL8SE) 

SELECT <FILE/M:CDeB,M;BlDCB*M:CIDCB*M:EIDCB#MJSIDCB,MiBeDCB,M:C8UCBij 

M:D0DGB*M:E8DCBiM!LeDCB#M:seDCBiMJpeDCBjM:ALDCB#M:LLDCB/MJSLDc9*i 

M!8CDCB # m:lIDCB,m;G8DCB) 

SELECT (FILE/MJCKDCB) 

SELECT (FILE/SSSR8M/BDBR8M) 

SELECT (FIlE#SIGMET/SIG7FdP/BPM) 

SELECT (FILE/L8PER8M/!BLlB) 

SELECT (FlLEjBTMjBLlB#BTMFlNTjBTMF8RT i BTML8ADiBTMEDlT 4 

BTmSYMB,BTMDEBG/BTmFER/BTmBPM/BTMBaSIC/BTMB8) 
SELECT (FILE/BTMNRES) 
SELECT (FILE/BPMSUPER/BTMSUPER) 
SELECT (FlLE/BT*DELTA) 

SELECT (FILE/CCI R88T/J8B/ LIMIT/ ASS IGN,L6AD, TREE/; 
TELSCPE/RUN/CCIDBUG/READeI/ENDj8B/AB8RT) 
SELECT (FILE/LDR/IN1/PS1/IN2*PS2>ALL,EVL/WrT) 

(FlLE*FILEMNGEiTPECHST,FMGEDCBS) 

(FILE^BRTRAN) 

(FILE/PREN) 

(FIl F'TAPFFCN) 

(FILEjCHKPTR8M) 

(file/symbl) 

(file#*m:passo#*m:assem#$m:r8bt) 

(file/bpmbasic) 



SELECT 

SELECT 

SELECT 

SELECT 

SELECT 

SELECT 

SELECT 

SELECT 

E8D 

PASS2 

STDLB 

STDLB 

STDLB 

STDLB 

STDLB 

DEVICE 

DEVICE 

DEVICE 

DEVICE 

DEVICE 

DEVICE 

DEVICE 

DEVICE 

DEVICE 

DEVICE 

DEVICE 

DEVICE 

DEVICE 

DEVICE 



(C/CRAC3), (fiC/TYAOl)/ (L6/LPA02) 
(P8/CPA04)/(B8>CPAQ4)/(LI/CRA03) 
(SI/CRA03)/(BI/CRAQ3)/(SL/LPA02) 
(S9/CPA04)/(CI*CRa03)/ (C8/CPA04) 
(AL#CPA04)/(EI/CRAQ3)/(E8/CPA04) 

TYA01*(HANDjKBTI8) 

CRA03j(HAND/CRDIN) 



(LLiLPA02)/(D8/LPA02) 



CpAQf 
PPA05 
PRA05 

LPAQg 

9TA80 
9TA81 
9TA82 
9TA»3 

7TAFO 

7TAE1 

DCAFO 

DCAF1 
nrwirP He»Ar-rs 

... i_ . . v^nr c 



:vi 

DEVICE 
DEVICE 
SDEVICE 

M8NIT8R 



DLIMIT 



DCBFO 

C8A10 

(LMN 



(PAPER, 26/132) 



(HAND,CRD8UT) 

(HAND/PTAP) 

(HANDjPTAP) 

(HAND/PRT8UT)/ 

(HAND/MTAP) 

(HAND/MTAP) 

(HAND/MTAP) 

(HAND/MTAP) 

(HAND/MTAP) 

(HAND/MTAP) 

( HANDED ISC 18 )/<SS/5A>/ (PSA/50)/ (PFA/IBO)/ (PER/ OQ) 

<HA\D/DlSCie)/(SS/5A>, (PSA/OO), (PFA/HOO)/ (PER/ 00) 
/ua^.riierinl . fCC.Ett . /oc*.nn» . /DrA.mnl . - «!-« ,. ~~ 

nutn ^^TCr-»n^ * CC 1 nn \ . i fit A n » . / Or A . r\\ . I a 



(HA\D,DISCIQ),(SS/1Q0), ( PSA/ 0) / ( PFA* 0) > < PER/Q ) 

(HAND/C6C) 
._ .ISSEG^CRA03 ) / (LMN/8SSEG/ LPAQ2/ CPAQ4 ) 

(TSTACK/300)/ (QUEUE/ 20)/ (C8RE/64)#j 
(SP88L/8)/(CP88L/6)/i 
(SFILi3C)i; 
(MP88L/10)/ (CFU,30) 
(TTME/15)/ (L8^100)/ (D8/100)/ (U8-»60)/ (P8/500 5#i 
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I <TS'T8RE#512># (PST8RE,200) , (FP88L#2) > ( IP88L>2) 

'RESERVE (MPATCH/044) 

A8Si1024 (L8A0ER),(CCI), (METASYM),(SYMB8L5,(FMGE),(F8RTRANH),; 
(PFIL), (WE8F)/(REW)/(U8PE)i ( FORTRAN ># (COBBLE (BASIC) 

BTM (NUMUSERSj24) 

8VERLAY <LMN*M:m8N)jJ 

(EF*(R88T>,; 

<M:RESDF), ; 

(CRD8UT)/j 

(FBCD)i) 

(BTMB8),; 

(BTMNRES)m 

(MSBTM)j 1 

(MJABS),j 

(7TAP),j 

(PTAP),j 

<CCL8SE),J 

(C88P)*J 

(HiSDEV)#j 

(I8Sym),j 

{HjCPU)i(M;jIT),(I8TABLE) #(I6RT)#j 

< HANDLERS) , (T8PRT), (PRGmLDR)j (TYPR), ( I8D) » (DEBUG)* (PUMP), j 

(M:ic)/(h;id)i(RDF),(8Pnl)#(8BsE)/(M:ie)#opn)#(cls)*(M8Dify)4; 

<EXlT)*(KEYIN),(Mil4)*<M:l5)/(MJ16>* (m:17)j (M:18)*(m;1A)*(MJ1B)* J 
(CLSl) # (SE3L8AD5j(LDPRG) # (MEMALeC)/(CALPR8C)#(WRTF)i(WRTD}/; 

{LBLT)#(M!19)*(P9S)#(AUTCP))#I 

( B I AS* ) * i N8TCB ) $ { MAP ) , ( ABS ) * ( SL* F ) * ( N8SYS|_ I B ) * ( PERM ) 

TREE R88T-J 

MJRESDF-j 

MIABS-; 

MSSDEV-; 

m:cpu-mjjit-I8table-; 
handlers*; 

I8SYM-; 

CRD8UT-J 

FBCD-; 

PTAP-; 

7TAP-J 

BTMB0-; 

m:btm»; 

C88P*I 

I8RT-T8PRT-I 

(PRGMLDR,TYPRjI8D»BTMNRES*j 

DEBuG*DUMP*EXlT-DUMP/M:l5*rU16#M:i7#KEYIN,MU*M; 
Mll8jM:iA/M:lBjM:iC/M:iD*HEMALeC#.RDF*(CALPR8C-; 

{8PNL»8BSEjM!lE'8BSE/8PN-eBSEjCLS-M9DIFY-; 
CLSl^SEGt8AD*8BSE.»; 

WRTF*WRTD»CCL8SE iLBLT*M: 19#P8Sj ; 
ALTCP)#LDPRG)5 
OVERLAY <LMN*CCI»*J 

(EF/CCClRe9T)/(j8B)# (LIMIT J#(ASSIGN) # (LOAD), (TREE)* (TELSCPE)/ j 
(RUN)*(CCIDBUG),(READBI>* (ENDJ8B) , ( A88RT >#{MIDLIMIT)/ (Mi JIT) ) 
(BIASM400)>J 

(N8TCB), (MAP), (PERM )*(SL*F)*(N8SYSLIB) 

ASSIGN M:EIi(FlLE#M;RESDF) 
FMGE (DELETE) 

ASSIGN M:Eli(FiLE/M:DLlMIT) 
FMGE (DELETE) 
ASSIGN M:EI,{FILF,M;FC8M} 
FMGE (DElETE) 

assign m:et,(File,m:jit) 

FMGE (DELETE) 

ASSIGN M:EI,(FILE*M;CPU) 

FMGE (DELETE) 

ASSIGN M:Eli(FlLEiI8TABLE) 

FMGE (DELETE) 

ASSIGN M;EI,(FlLF,MiSDEV) 

FMGE (DELETE) 

ASSIGN MjEti (FlLE/MSSfM) 

FMGE (DELETE) 

assign m:ei, (FIle*m:abS) 

FMGE (DELETE) 
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L8aD <SL*F)/ (MaP)*(N8TCB)*(PERM)*(ABS)*; 

(BlAS/COOC)*; 

(LMN, FORTRAN! )*(EF* (BTMF JNT ) * (BTMF8RT ) ) 

I fiAH /PI .Ct . (MiDt ./MRTrRt ./DCTDMt • f tRCl , i 

(BIAS/C0O0)*; 

(LMN, LOAD!) *<EF* (BTML8AD)) 

LOAD (SL*F)/ (MAP), (NOTCB)* (PERM)/ (ABS)/; 

(BIAS/COOO)*; 

(LMN, EDIT!) *(EF* (BTMEDIT)) 

LOAD (SL*F)/ (MAP)* (NBTCB ) * (PERM)/ (ABS)*; 

(BIAS/COOO)* j 

(lmn, symbol:) , (EF, (Btmsymbh 

LOAD (SL*F)* (MAP)* (N8TCB), (PERM)* (ABS)*; 

<BIAS*C000)*; 

(LMN, FERRET!) *(EF, (BTMFER)) 

LOAD (SL/F)/ (MAP)* (N8TCB), (PERM)/ (ABS)*; 

(BIAS/COCO)* ; 

(LMN* BPMJ) *(EF* (BTMBPK)) 

LOAD (SL/F)/ (MAP), (N8TCB)* (PERM )*{ABS)*; 

(BIAS/C000)*! 

(LMN* BASIC!) *(EF* (BTMBASIO) 

LOAD (MAP), (N8TCB), (PERM), (ABS),; 

(BlAS*C00C)*i 

<LMN,SUPER! ), (EF, (BTMSUPER) ) 

L8AD (SL*F)/ (MAP), (N8TCB), (PERM)* (ABS)*; 

(BIAS/COOO)/! 

(LMN, DELTA!) *(EF* (BTMDELTA)) 

J8B !SYS*DELETE*F 

ASSIGN MJEI* (FILE*PASS2) 

FMGE (DELETE) 

ASSIGN M!EI,(FILE*PASS1) 

FMGE (DELETE) 

J8B !SYSGEN,SYSGEN 

8VERLAY (LMN, FMGE)*i 

(EF*(FILEMNGE)*(TPECHST), ( FMGEDCBs ) ) * ; 

(BlAS*4400)*; 

(MAP)*(SL/F>* (N8SYSLIB)*(PERM) *(TSS*tOO) 
8VE.RLAY (LMN/L8ADERJ* ; 

(EF*(ALD* (EVL), (IN1)*(IK2)*(LDR) , (PSl )* (PS2) * ( WRT ) ) , ; 
(BIAS/4400),; 

(NBTCB)/ (MAP)/ (PERM)/(SL*F),(N6SYSLIB) 
L8AD (LMN*L8PE)* (MAP) , (NBTeB)* (EF* (L8PER9M))*; 
(BIAS/4400)*; 

(Perm) 

load (lmn* super >,(n8tcb),( map) * ( abs ) * < ef* ( bpmsuper ) )/; 

(BIAS/4400)*! 

(PERM) 

LOAD (LMN/ SYMBOL )/ (PERM), (MAP)*; 

(BIAS/4400),; 

(EF/ (SYMBL),; 

(M;8CDCBi, (M!DQDCB), (MIGeDCB)/ (MJSIDCB)/ ( M J B8DCB ) , (MILSDCB ) * ( MJCDCB) ),; 

(SL/F) 

8VERLAY (EF, (*M:R88T),($N!PASS0), ($M:aSSEM)*; 

(M;D8DCB)* (M:CDC=n, (M!L8DCB), (MSB8DC3)* (MIG8DCB)* (MISJOCB)* j 

(M!S8DCB), ; 

(M!CIDCB)* (M;c8DCB)*{M!LLDCB)*(M!8CDcB)); 

*(ABS)* (PERM)* (SL*F)*1 
(BIAS* 4400)*; 

(LMN,METASYM)* (TSS*80) , < MAP) * (UNSAT* ( ISYSGEN)) 

TREE $M:R88T»^:B^DCB"M;CDCB *M;CIDCB-M;CaDCB*M JD8DCB*M!G8DCB"; 

MJS8DCB-; 

MJLLDCB»M!L8DCB«M!8CDCB»M!SIDCB-(*m:PaSS0/*M!ASSEM) 

ASSIGN M!EI,(FILE, $M!ASSEM) 

FMGE (DELETE) 

ASSIGN M!EI*(FILE* $M{PASSO) 

FMGE (DELETE) 

ASSIGN M!EI*(FILE* *MJRB8T) 

FMGE (DELETE) 

LOAD (LMN*F8RTRANH)*(PERM),(EF* (F8RTRAN) * (M!CDCB)* (MJSIDCB)* ; 

(MID8DCB)*; 

(MiBeDCB)* (MJL8DCB))*; 

(SL*F)*; 
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(BIAS#4400),/ 

(MAP) 

ASSIGN MiEI,(FlLE, F9RTRAN) 

FMGE (DELETE) 

ASSIGN m:EI,(FIlE,BTMF8RT) 

FMGE (DELETE) 

ASSIGN M?EI,(FILE,BTM8ASIC) 

FMGE (DELETE) 

ASSIGN M!EI,<FILE/BTMDEBG> 

FMGE (DELETE) 

ASSIGN MjEI,(FIL-E,BTMSYMB) 

FMGE (DELETE) 

ASSIGN M:EIj(FILE*BTMLOAD) 

FMGE (DELETE) 

L8AD (LMN,FRAN), (EF, (FREN)), (N8TCB), (MAP) t (PERM) i 1 

(BIAS/ 4400),; 
(ABS) 

l6ad (lmn, basic ),( map ),(ef,(bpmbasic),{mseidcb>,cmse8dcb)>(m?d8dcb) ,j 
(mjsidcb)/(m:l9dcb)>#j 

(BIASM400),* 



(PERM) 

l8ad (lmn,sdb 
l8ad (lmn,m!al 
lsad (lmn,m:bi 

L8AD (LMN,MjB8 

L8AD (LMN,M!CI 

L8AD (LMN/MJC 

L8AD (LMl^iMSCK 

L8AD (LMN,M!C8 

L8AD <LMN,MJD8 

L8AD (LMN,m;EI 

L8aD (LMN/M1G8 

L8AD (LMN,M!E8 

L8AD <LMN,M!LI 

L8AD (LMN,m:LL 

LBaD (LMNbMJLS 

L8AD (LMNjMjSC 

L8AD (LMN,M!P9 

L8AD (LMN,MJSI 

L8AD (lmn,m:sl 

L8AD (LMN,H;S8 

L8AD (LMNjSSS 
8VERLAY (LMN,RE 
(EF,(TaPEFcN), 
(M?SiDCB),(M:e 



(EF,(BDBR8M )) 
(EF/(M!ALDcB)) 

(EF#(m;bidcB)) 
(ef,(m;bsdcb)) 
(EF,(m:cidcB)) 
(ef,(m;cdcb))* 
(EF,(m;ckdcb>> 
(EF#(m;c8Dcb)) 

(EP,(M;DeDCB)), 

(EFi(m;eidcB)> 

(EF,(M!G8DCB)) 

(EF,(m;e8Dcb>) 

(EF,<m:lIDcB)) 
(EFi(MJLLDcB)) 
(EF,(MJL8DCB)) 
(EF, (MJ8CDCB)) 
(EF,(M;P8DCB)) 
(EF,(M;siDcB)) 
(EF, (m:sldcb)> 

<EF, <M?S8DCB)) 
(EFj(SSSR8h )) 



,(MAP^ 


•(PERM, LIB) 


#(N8SYSLIB) 


,(MAP), 


•(PERM, LIB) 


^(NBSYSLIB) 


,(MAP)j 


»(PERM,LIB) 


#(N8SYSLIB) 


,(MAP), 


p(PERM,LIB) 


,(N8SYSLIB) 


,(MAP>, 


•(PERM,LIB) 


#(N8SYSLIB) 


(MAP)/ 


(PERM/LIB) 


/(N8SYSLIB) 


,(MAP>; 


•(PERM, LIB) 


/(N8SYSLIB) 


,(MAP)j 


•(PERM, LIB) 


#(N8SYSLIB) 


#(MAP)j 


»<PERM,LIB) 


/(N8SYSLIB) 


» (MAP), 


•(PERM,LIB) 


i(N3SYSLIB) 


,(MAP)j 


i (PERM, LIB) 


/(N8SYSLIB) 


,(MAP), 


•(PERM, LIB) 


#(N8SYSLIB) 


,(MAP)j 


•(PERM, LIB) 


MN8SYSLIB) 


,<MAP)j 


•(PERM, LIB) 


,(N8SYSLI8) 


/(MAP); 


•(PERM, LIB) 


#(N8SYSLIB) 


,(MAP)j 


i(PERM,LIB) 


HN8SYSLIB) 


,(MAP), 


MPERM,LIB) 


/(N8SYSLIB) 


,(MAP)j 


•(PERM, LIB) 


#(N8SYSLIB) 


,(MaP)j 


•(PERM, LIB) 


,(N8SYSLIB> 


,(MAP), 


•(PERM, LIB) 


,(N8SYSUB) 


/(MAP), 


•{PERM, LIB) 


/(N8SYSLIB) 



)*} 

TFECHST),(M:8CDCB),(M;CDCB) 

. .-„- ,.DCB)#(M;LLDCB)i(MJL8DCB)#(M. 

<M:C8DCB),(M:D8DCB),(M;ciDCB)#(MiSLDCB),(Mj 
(MJLIDCB), (MJG9DCB) )* t 
(BIAS* 4400), i 

(MAP),(SL#F),(N8SYSLIB) 
TREE TAPEFCN.TPEeHST*M?eCDCB-M!CDC3»M:Bl 
•M:EIDCB^M{LLDCB»^:L8DC8*M:P8DCB-m;E8DCB*Mj 

•m:sldcb»m:aldcb*m:s8dcb«m:lidcb«»m:g8dcb 

ASSIGN M'EIj (FILE,REW) 

ASSIGN M!E8, (FILE,WE8F) 

FMGE (ENTER, PERM) 

ASSIGN MJE8,(FlLE,PFiL) 

FMGE (ENTER, PERM) 

8VERLAY (LMN^LAY )#J 

(EF,(ALL),(EVL),(IN1),(IN2),(LDR) 

(BIAS, 4400), I 

(N8TCB),(MAP), (PERM),(SL 
TREE LDR.(IN1,PS1/IN2,PS2-{ALL,EVL,WRT 
J8B !SYSGEN,DEFIT 

ASSIGN MJP8, (DEVICE, 9T), (8UTSN,P8SS) 
DEF ( INCL>SIGMET,SIG7FDP,BPM, SBLIB,BTMIBLIB 
FIN 



(MSBIDCB)#(M}B8DCS)*I 

PeDCB),{M;E8DCB),j 

ALDCB),(MJS8DCB),; 



, (PERM) ,(TSS,100) 

DCB»MJB8DCB*M;SIDCBJ 

C8DCB*M;d8DCB»MJCIDCBI 



,(PSi),(PS2),(WRT)),j 

,F),(N8SYSLIB) 

)) 
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32K SYSTEM GENERATION 



IGtNDCB (MSB!/ iSYSGEN/ ( INSN/6TMB) ) 
END 

J8B :SYS/MAKER88M 
ASSIGN M;EI/ (FILE/MJM8N) 
FMGE (DELETE) 
J8B JSYSGENjSYSGEN 
ASSIGN MjBl, ( INSN/BTMB) 
PASSl 
SELECT (FIlE/BTM:BlIB/BTMfINT/BTMF8RT/BTMl8AD/BTMEd1T/ 

BTMSYMBjBTMDEBG#BTMFERjBTMBPMj»BTMBASIC*BTMB8) 
SELECT (FILE/8TMNRES) 
SELECT (FILE/8PMSUPER/BTMSUPER) 
SELECT (FILE#BTHDELTA) 

SELECT (FILE/R88T/7TAP/FBCD/ I8RT/HANDLERS* T8PRT/ IB* ; 
PRGMLDR/TYPR, IBD/DEBUG/DUMp/EXlT/M:l5/ M J lfe/M : 17* KEYIN/M ! 1*/ ; 

M:i8ih:iA,M:iB,M;iC/fi:iDiRDF/i 

ePNL^eBSE^MjlE^BPN/CLS^MeDlFY^ClSl^SEGLBADjLDPRG/MEMALeCCALPRBC*; 

WRTF,WRTD,DuMKYCCL,LBLT,M:i9/P8SjALTr.P) 

SELECT (FILE/CRD8UT/PTAP/DFBCD) 

SELECT (FILE/I8SYM/C88P/CCL8SE) 

SELECT ( F ILE/CC I R88T/J8B/ LIMIT/ ASS IGN,L8AD, TREE/ j 

TELSCPE/RUN,CCID8UG/READBl/ENDj8B/AB8RT) 

SELECT (FILEjLDR/IN1jPS1/IN2/PS2/ALL/EVL/WRT) 

SELECT (FILE*FILEMNGE,TPEChST/FMGEDCBS) 

SELECT (FILE/F6RTRAN) 

SELECT {FIlE/S!GVET/SIG7FdP#BPM) 

SELECT (FILE/FREN) 

SELECT (FILE/LRPFP8M/ !BLIB) 

SELECT (FlLE/TAPrrCN) 

select (filE/ m :cdcb/M;bidcb*m;cidcb/m:eidcb/m:sidcb/m:bbdcB/Mjcbdcr/ ; 

^:DeDCB/M:freDCB,^:LQDCB/M:sSDCB/M;peDC8/H:ALDCB/M:LLUCB/M;SLDCB,; 

m:bcdcb#m:liocb,!*:gbdcB) 

SELECT (PlLEi M :ci<rcB) 

(FlLE#SSSR8M/BDBR8M) 
(FILE/CHKFTR8M) 
(FILE^SYMBL) 

(filE/«m:fassO/$m;assem/$m:r88T) 



SELECT 
SELECT 
SELECT 
SELECT 
SELECT 
SELECT 

E8D 

passb 
stdlb 
stdlb 
stdlb 
stdlb 
stdlb 

DEVICE 
DEVICE 
DEVICE 
DEVICE 
DEVICE 
DEVICE 



(FILE#BPMBASIC) 
(FILE#CN7C4363,CN704364,CN704365/CN704366) 



(CCRAC3)/ (eC/TYACl)/(Le/LPA0H)/(LL/LPA02)/(D8*LPA02) 
(PS/CPAQ4), (B8iCPA04)/ (LI*CRAQ3) 
(SI/CRA03)* (BI/CRA03)/ (SL*LPA02) 
(S8/CPA04)/ (CI/CRA03J* (C8/CPAQ4) 
(AL/CPAC4), (EI*CRA03)/ (E8/CPA04) 
TYAOl* (HAND/KBTI6) 
CPA03/ (HAND/CRDIN) 
CPA04* (HAND/CRD8UT) 
LPAQ2/ (HAND/PRT8UT)/ (PAPER/26/132) 
9TAg0* (HAND/MTAP) 

9TA81/ (HAND/MTAP) 

DEVICE DCAF0*(HAND/DISCI8)/(SS,5A)/ (PSA/50)/ (PFA/1BO)/ (PER/ 00) 
DEVICE DCAF1/(HAND/DISCI8)/(SS/5A), (PSA/OO)/ (PFA/140)* (PER* CO) 
DEVICE DCADO/( HAND/ DISC 16 )/(SS/05A)/ (PSA/O)/ (PFA/O)/ <PER*0) 
DEVICE C8A10/(HAND/C8C) 

SDEVICE (LMN/ISSEG/CRA03)/(LMN/8SSEG/LPA02) 

M8NIT8R (TSTACK/250)/ (QUEUE* 10 )* (C8RE/32 >/ (SFlL*3Q)*j 
(SP88L/6)i(CP88L/^)*i 
( MP68L/ 05 ) 
DLIMIT (TlME/15)*(L8/l00)/(DB/i00)*(U8/60)/(P8/500)*; 

(TST8RE/512)/ (PST8RE/200) / (FP98L*2) , { IP88L* 2) 
RESERVE (MPATCH/020) 
ABS*1024 (L8ADER)/ (CCI)/ (^ETASYM)/ (SYMBOL)/ (FMGE ) / (F8RTRANH ) / j 

(PFIL)/ (WE8F),(rEW)#(L8PE)/ (BASIC) 

BTM (NUMUSERS/4)/ (USERSIZE/15872) 
8VERLAY (LMN/M'MBNi/i 
(EF/(R88T)/j 
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(mjresdfj, i 

(DFBCD)ii 

(CN7q*364)# (CN704365)#(CN7c4366)^; 

(BTM88),; 

(MlBTM), j 

(BTMNRESiji 

(MJA8S),; 

(CCL8SE),; 

(m:sdev)#; 

U8SYM),; 

(M:CPU)j{MJJIT),{IBTABLE) #<I8RT),; 

(CRDrUT),; 

(HANDLERS). (TqPrT), (PrGmLDR)* (TYPR), ( I8D)# (DEBUG)* (DUMP), j 

(M:lC>,(M:iD)*{RDF),(ePNL),(eBSE),{MilE),(8PN),(CLS)/(M8DJFY),J 

(exit) j (keyin) # (m:i4) # (m:i5)*(m!i6)/{mu7)#(m:i8}#{m;ia)#{m:ibj*i 

(CLSl),(SEGL8AD),(LDPRG),<MEMAL8C),(CALPR8e)#(WRTF),(WRTD),; 
(LBLf)#(M:i9)*(PSS>*(ALTCP))il 

(BIASjQ),(N8T03),(MAP),(ASS),(SL*F),(N8SYSlIB),(PERM> 

TREE R88T-J 

MJRESDF-; 

ISSYm-j 

MSABS-; 

MISDEV^j 

«JCPU»M!jIT»I9TABLE-i 

HANDLERS*-; 

CRD8UT-; 

DFBCD-; 

CN704364-CNJ7C4365*CN704366«j 

BTMB8-; 

MSBTM*; 

C89P-J 

I8RT-T6PRT-; 

(PRGMLDR,TYPR# I8D-BTMNRES/ i 

DE8uG»DUMP#EXIT*DUMP#MS15*M!16*m;17#KEYIN#m:14#j 
M:i8jM:iA/M!lB#K:iC#M:iD/MEMALBC/RDF-(CALPReC»i 

(8PNL-8BSE^JlE-9BSE,8PN-eBSE,CLS*M8DIFY-; 
CLS1,SEGL8AD«8BSE,; 

WRTFjViRTD.CCl8SE jLBLTjM j 19, P8Sj I 
ALTCP))jLDPRG) 
OVERLAY CLMN*CCU*; 

(EFj(CClR88T)#(J8B), (LIMIT), (ASSIGN), (L8AD), (TREE) j(TELSCPE)j; 
(RUN)j(CCIDBUG), (READBI ) , (ENQJ8B) , (A89RT ) / (M5DLIMIT )t (MS WIT ) ) 
(BIASJ3800)*; 

(N9TCB), (MAP),(PERM)j<SLjF)j(N8SYSLIB) 

assign m:ei#(file,m:resdf) 

FMGE (DELETE) 

assign m:ei#<-file*m:diimi.t> 

FMGE (DELETE) 

ASSIGN M!EIj<FIlF/jM!FC8m) 

FMGE (DELETE) 

assign m:ei,(file*m:jiT) 

FMGE (DELETE) 

ASSIGN M!EI,(FILE>MSCPU) 

FMGE (DELETE) 

ASSIGN M!EIi(FlLE,I8TABLE) 

FMGE (DELETE) 

ASSIGN M!EI#(FILEjM:SDEV) 

FMGE (DELETE) 

ASSIGN M:ETj (FILE#M:BTM) 

FMGE (DELETE) 

ASSIGN MiEli (FILE/MJABS) 

FMGE (DELETE) 

L8AD ( Sit F ) / ( MAP ) , ( N8TCB ) , ( PERM } / ( ABS ), j 

(BIAS/4200)ji 

(LMN, F8RTRAN!),(EF, (BTMFINT ) , (BTMFSRT ) ) 

L8AD (SLjF)/ ( MAP ),(N8TCB), (PERM) /{ ABS) $i 

(BIAS/ 4200) j J 

(LMN, L8AD:> j(EF, (BTML9AD)) 

L8AD (SLjF )* (MAP), <N8TC8)j (PERM)/ ( ABS) jj 

(BIAS/4200)jJ 

(LMN, EDIT!) /<EF, (BTMEDIT)) 
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L8AD (SL/F)/ (MAP) ,(N9TC8)/ (PERM)/ (ABS),; 

(BIASM200),; 

(LMN, SYHB8LI) , (EF, (BTMSYMB)) 

L8AD (SL/F)/ (MAP), (N8TCB), (PERM)/ (ABS), J 

(BIAS/4200),; 

(LMN, FERRET?) , (EF, (BTMFER)) 

L6AD (SL/F)/ { MAP), (N8TCB),( PERM) /(ABS),; 

(BIAS/4200), ; 

(LMN, BPM!) , (EF, (BTMBPM)) 

L8AD (SL/F)/ (MAP ),(N8TCB), (PERM ),(A3S),; 

(BIAS/4200)/; 

(LMN, BASIC!) , (EF, (BTMBASIC)) 

L8AD <MAP),(N9TC5), (PERM)/ (ABS),; 

(BIAS/4200)/; 

(LMN^SUPER: )/ <EF, (BTMSUPER) ) 

L8AD (SL/F)/ (MAP), (N9TCB), (PERM)/ (ABS), j 

(BIAS/4200)/! 

(LMN, DELTA!) , (EF, (BTMDELTA)) 

8VERLAY (LMN/FMGEJ/J 

(EF/(FIUEMNGE)/(TPECHST), (FMgEDCBS)),; 

(BIAS/3800)/; 

(MAP)/ (SL,F),(N8SYSLIB), (PERM) , <TSS,1Q0) 
8VERLAY (UMNjLSADER)/; 

(EF/(AU)/<EVL),CIN1),UN2)/(LDR) / <PSl )/ (PS2)# ( WRT ) ),; 
(BIAS/3800)/ ; 

(N9TCB),(MAP), (PERM),(SL,F),(N9SYSLIB) 
J8B iSYS, DELETE, F 
ASSIGN MlEI, (FILE/PASS2) 
FMGE (DELETE) 
ASSIGN MJEI, <FILE,PASS1) 
FMGE (DELETE) 
J8B :SYSGEM,SYSGEM 
L8AD (LMN, SUPER ), (N8TCB), (mAP), (ABS), (EF# (BPmSUPER) )/; 

(BIAS/3800)/; 

(PERM) 

L8AD (LMN,SYMB9U, (PERM), (MAP),; 

(BIAS/3800)/; 

(EF/ (SYMBL)/ I 

(M;8CDCBlJiM:D9DCB)/(M;GeDCB)/(M:SIDCB)/(MiB9DCB)/(MIL8DCB),(M:CQCB) Ui 

(SL/F) 

8VERLAY (EF, (*M:R99T ) / ($M JPASSO) / (SMJASSEM),; 

(M:DeDCB),(M:CDCe),(M:L8DCB)/{MJ88DCB),(M:G8DCB), (MJSIDCB),; 

(M:S8DCB)#; 

(M;CIDCB), (M:C9DCB)/(M:LLDCB)/ (MISCDCB)); 

, (ABS), (PERM)/ (SL/F)/; 
(BIAS/3800),; 

(LMN,METASYM), ( TSS, 80 5 , ( MAP ) , (tjNSAT, ( :SYSGEN) ) 

TREE *M!R99T* m :B9DCB-M;CDCB »M :CIDCB»M :C9DCB-M :DBDCB-M JG8DCB- ; 
MIS8DCB-; 

m:uldcb-m:l9DCb»^:9CDCB.m:sidcb-($m;passo/$m;assem) 
assign m;ei,(file/ $m;assem) 

FMGE (DELETE) 

ASSIGN M!EI/(FILE, $MJPASS0) 

FMGE (DELETE) 

ASSIGN M:EI,(FI|_E, $M:R98T) 

FMGE (DELETE) 

LBAD (LMn,F8RTRaNH)/(PERM),(EF # (F9RTRaN),(MJCDCB)/(M;SIDCB),; 

(M:D9DCB)i; 

(M*BbDCB), (M:L8DCB))/; 

(SL/F)/; 

(BIAS/3800)/; 

(MAP) 

L8AD (LMN,|_8PE), (MAP), (N8TCB)/ (EF, (L9PER9M) ),; 

(PERM) 

ASSIGN M:EI#(FILE* F8RTRAN) 

FMGE (DELETE) 

ASSIGN M:EI, (FILE/BTMF8RT) 

FMGE (DELETE) 

ASSIGN MJEI,(FILE/BTMBASIC) 

FMGE (DELETE) 

ASSIGN M'EliiFlLE/BTMDEBG) 
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FMGE 


(DELETE) 




ASSIGN M;EI*{FILE*BTMSYMB? 




FMGE 


(DELETE) 




ASSIGN M;El*(FlLE*BTML8AD) 




FMGE 


(DELETE) 




L8AD 


(LMN*FRAN), (EF*(FREN))*(N8TCB)* ( MAP )*( PERM) » i 




(BIAS 


>#38GC)*J 




(ABS) 






L8AD 


(LMN* BASIC) *( MAP) #(EF*(BPMBASIC)*(M!ElDCB)*(M 


;E8DCB)*(M!d8DC8) , ; 


(MjSlDcB)* (MJL8DCB))* J 




(BIAS 


>*3$OQ),i 




(PERM) 




L6AD 


(LMN/BDB ), (EF*(BDBR8m ))* (MAP), (PERM, LIB) 


*(N8SYSLIB) 


L8AD 


(LMNiM! 


AL), (EF* (M:ALDcB))i(MAP), (PERM, LIB) 


* (N8SYSLIB) 


L8aD 


(LMK!,M 


BI)*(EF*(M:8IDCB))*(MAP)*(PERM,LIB) 


#(NeSYSLIB) 


L8AD 


(LMN/M 


EB8), (FF, (m:B8DCB) ), (MAP), (PERM,LIB) 


*(N8SYSLIB) 


L8AD 


(LMNiM 


SCI ),(EF, (MICIDCB)),(MAP),(PERM,LIB) 


*(N8SYSLIB) 


L8AD 


<LMN,M 


!C >* (EF#(M:cDCB) )t (MAP)/ (PERM/ LIB) 


#(N8SYSLIB) 


18AD 


(LMN/M 


sco* (EF, (m:ckdcB))*(Map),(perm,liB) 


HN8SYSLIB) 


L8AD 


(LMN,M 


'C8),(FF,(M:ceDCB)),( MAP), (PERM, LIB) 


*(N8SYSLIB) 


L9AD 


(LMN,M 


D8), (EF,(M:08DCB) ), (MAP), (PERM, LIB) 


/(N8SYSLIB) 


L8AD 


(LMN*M 


ED*(EF,(M:ElDrB))*(MAP),(PERM,LlB) 


*(NQSYSLIB) 


L8aD 


(LMN,m 


G8),(EF,(M:GeDcB))*(MAP)*(PERM,LlB) 


*(N8SYSLIB) 


L8AD 


(LMNjNI 


E8),(EF,(m:e6DcB)>, (MAP), (PERM, LIB) 


*(N8SYSLIB) 


L8AD 


(LMN*M 


,LD* (EF, (M:lIDCB)),(MAP),(PERM,LIB) 


* (NQSySLlB) 


L8AD 


(LMN^M 


'LL)*(EF, (MILL DCS))* (MAP)* (PERM, LIB) 


* (N8SYSLIB) 


L8aD 


(LMN,M 


•L8>* (EF*(M:L8DcB))* (MAP)* (PERM, LIB) 


*(N8SYSLIB) 


L8AD 


(LMN,M 


!8C),(EF,(M:ecDCB>),( MAP), (PERM, LIB) 


* (N8SYSLIB) 


L8AD 


(LMN,M 


P8),(EF*(M:peDcB)>*(MAP)*(PERM,LIB) 


*(N9SYSLlBi 


L8AD 


(LMNjH 


si), (Ef*(m;siDcB))*(map)*(perm*lib) 


#{N8SVSLI8) 


L8AD 


(LMNjM 


SL), (EF,(M;sLDC3))* (MAP)* (PERM, LIB) 


*(N8SYSLIB) 


L8AD 


(LMN,m 


S8), (EF, (MIS8DCB))* (MAP), (PERM, LIB) 


*(N8SYSLIB) 


L8AD 


(LMN,SSS ), (EF, (SSSR8M ) ) » ( MAP ) * ( PERM, L IB ) 


,{N8SYSLIB) 


OVERLAY (LmN*REw)*; 




(EF*(TAPEFcn)*(TPECHST)* (M !8CDCB ) * (M JCOCB) * (MJBIDCB )* (M:t$8DCB) * ; 


(M:SIDCB),(m:EIDCB)*(M:lLDCB)*(M!L8DCB)* (M:PSDCB), 


(m:E8DC3),; 


(M'CeDCB)* (M:D8DCB)#(M:CIDCBJj{MJSLDCBJ/ (Mja.LDCB)j 


(M:S8DCB?*| 


(M?LIDCB)* (M:G8DCB) )*; 




(BIAS 


#3800)*; 






(MAP) * (SL/F), (N8SYSLIB), (PERM) 


* (TSS,J00) 


TREE 


tapefcn-tpechst-m:8CDCb-m:cdcb»m;Bidcb-m:b8dcb-m:sidcb; 


- M :ElDCB»M;LLDCB-^!LSDCB»M:P0DCB»M:EeoCB»MsC9DCB*M 


;d8DCB-m;cidcb; 


-m:sl0cb-^:aldcb-m:s8dcb*m:lidcb*m:gbdcb 




ASSIGN MtEIi(FlLE#REW) 




ASSIGN M:E8,(FIlE/WE8F) 




FMGE 


(ENTER#PERM) 




ASSIGN M;E8* (FIL F*PFlL> 




FMGE 


(ENTER*PERM5 




9VERLAY (L M .N#BLAY )*; 




(EF*(ALD* (EVL), (IN1')*(IN2)*(LDR) * (PS1 ) * (PS2) * ( wrt ) }, ; 


(BIAS 


#3800), ; 






(N8TCB)*(MAP)* (PERM), ( SL *F ) * ( N8SYSL IB ) 


TREE 


LPR»(IN1*PS1*IN2,PS2-*(ALL*EVL*WRT ) ) 




jsb : 


SYSGENjDEFIT 




ASSIGN M:P3* (DEVICE*9T), (8uTSN,P8SS) 




DEF (INCL*SIGMET/5IG7FDP*BpM*IBLI3*BTm:BLIB) 
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INDEX 



!EOD record (BASIC subsystem), 14,54 
JOB card (BASIC subsystem), 14 
JOB card (BPM subsystem), 15 
BLIB file, 76 
BTM account, 37, 76 
BTM card, 74, 76 
DEVICE cards, 75 
MONITOR card, 75 
RESERVE card, 76 
SELECT cards, 75 
STDLB cards, 75 



BTM scheduling, 65 

BTM system CALs, 59 

BTM system generation, 74 

BTMM key-in, 67 

BTMQ message, 67 

BTMS key-in, 67 

BTMX key-in, 67 

buffer overflow, 8 

buffer size, 8 

BUILD command (EDIT subsystem), 19 

build new fiie (EDIT subsystem), 19 

BYE command (Executive), 7 



account, 13 

account number, 13 

accounting file, 4 

accounting log, 54 

acknowledge code (Teletype), 8 

activation character, 8, 9 

activation class, 8,9,10 

activation procedure, 4 

ACTIVITY command (FERRET subsystem), 29 

allocation of swap area, 75 

ASSIGN command (Executive), 5 

asterisk (FORTRAN IV-H subsystem), 35 

asterisk in column 1 (BASIC subsystem), 14 
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